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PREFACE 


This booklet presents the most frequently used features of the UNIVAC 1100 Series 
Executive (EXEC 8) for the typical user programmer. 
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1. CONTROL STATEMENTS 


NOTATIONAL CONVENTIONS 


The general EXEC 8 control statement format is as follows: 


LABEL OPERATION OPERAND 
FIELD FIELD FIELDS 
at 


@ [label:] command [,options] parameters {. comment] 
Brackets are used to indicate optional fields or subfields. 


The operation field is terminated by one or more spaces. 


The operand fields specify parameters associated with the command fields. These are 
separated by commas and are specified by the user as dictated by his requirements. The 
content of each operand field, the number of operand fields, and whether each is re- 
quired or optional varies with the command selected. Operand fields, in turn, may 
contain parameter subfields that are separated by a slash (/). For the most part, these 
subfields are optional within a field. Thus, it is possible to specify parts of a field 
without specifying the entire field. 


When parameter fields and subfields are optional, the following rules apply, where an 
empty field is defined as one that contains no nonspace characters: 


(1) Parameter field separators must be specified, left to right, through the last param- 
eter given; fields preceding the last parameter may be empty; trailing field separators 
need not be specified. 


(2) The same holds true of parameter subfield specifications within a field. 
Leading spaces within a statement are permissible in the following cases: 

@ ~=Following the at (@) character 

@ Following a colon (:) when a label is specified 

® Following a parameter field separator (,) 

@® Following a parameter subfield separator (/) 


A space, placed at any position in the coding other than those listed, is interpreted as 
the termination of the image. 


In both batch and demand processing, data images and control statements in a run 
stream are processed sequentially and only upon request by the executive or by a 
program operating in that run. : 


However, a special mode of processing control statements is available during demand 
processing. This mode directs the executive to process a control statement immediately 
after it has been input from a remote inquiry terminal. The processing called for by 
the control statement is also done independently of any current program execution or 
control statement processing in the run stream. This mode of executing a control 
statement is specified by a special character, a second @, in column 2 on the control 
statement. This mode of operation is called transparent mode, and control statements 
which can direct or specify this mode of operation are called transparent control state- 
ments. 


Transparent control statements are a subset of the control statement set. The syntax 
rules for norma! control statements, with the following exceptions, also apply to trans- 
parent control statements. The exceptions are as follows: 


(1) The identification of a transparent control statement consists of a @@ versus a 
@ for a normal control statement. 


(2) The use of a label on a transparent control statement, while not prohibited, is 
meaningless. 


The following discussion concerns the conventions for file or element names, the most 
common contents of the parameters. 


Although the distinction between filenames and element names is often evident from 
the context, there are many cases where a period must follow a filename, or it will 
be either not accepted, or incorrectly treated as an element name. Therefore, it is 
best to always specify the period, as shown below: 


filename is used to indicate: [{qualifier] *] file [(F-cycle)] {/{read-key] [/write-key] ]. 


eltname is used to indicate: [filename.] element[/version] [(element-cycle) } 
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Qualifier, file, element, and version names are 1—12 alphanumeric Fieldata characters ($ 
and — characters are also allowed). Keys have 1—6 characters from the entire Fieldata 
character set, excluding only space, comma, slash, period, and semicolon. F-cycles are 
numbered upward from 1 to 999; element cycles are numbered upward from 0. 


When the qualifier is omitted, the project-id from the @RUN control statement is used, 
except in the special case where a jeading asterisk appears before the filename and a 
qualifier has been previously furnishea on a @QUAL statement. When the F-cycle or 
element-cycle number is omitted, the most recently created cycle is used. 


When the filename portion of an eltname is omitted, the system usually assumes an 
implicit reference to the run’s temporary program file, TPFS. 


A relative F-cycle of (+1) must be used to distinguish a newly assigned ‘‘to be cataloged”’ 
file (see @ASG,C and U options) from an existing catalogued file of the same name. 
A relative F-cycle of (—3) would designate the fourth oldest file that was catalogued 
under the specified filename. Element cycles are referenced by their actual number, 
such as (0) or (6). 


Each item (image) in a symbolic element has a cycle number that indicates to which 
element cycle it was entered, and, if deleted, a cycle number to indicate in which 
cycle the item was deleted. When an element is updated, the added items are given 
an entered cycle number one greater than the last cycle of the element and the deleted 
items are given a deleted cycle number one greater than the last cycle of the element. 


When specifying a symbolic element for compilation or assembly, the user may select a 
specific update from a sequence of retained updates by referencing the proper cycle 
number as part of the element name. 


A system-standard maximum of five consecutively numbered cycles may be retained in 
a symbolic element. This maximum may be set to any value needed (up to 63) for 
a particular element by the use of the @CYCLE control statement. As soon as the 
number of retained updates for an element exceeds the specified maximum, the update 
with the lowest numbered cycle is combined with the update having the next higher 
cycle number to create a new cycle which in effect becomes the oldest cycle of the 
element. 


A particular cycle may be referenced by either an absolute or a relative cycle number. 
Absolute cycle numbers are unsigned integers in the range 0 to 62; however, since only 
a limited number of cycles are retained, the absolute cycle numbers used when referencing 
an element must be in the range of those absolute cycles retained. Relative cycle 
numbers are signed integers. If the relative cycle is given as —n, then absolute cycle 
r—n is referenced, where r is the most recent absolute cycle retained. If +n is used, 
then absoljute cycle xtn is referenced, where x is the oldest absolute cycle retained. 
The use of relative cycle numbers makes it unnecessary to know the absolute cycle 
number of either the oldest or most recent cycle retained. 


Since absolute cycle numbers may not be greater than 62, when absolute cycle 62 of 


an element is updated all retained cycles are renumbered. The renumbering assigns 
cycle 0 to the oldest cycle retained, 1 to the next oldest, and so forth. 


SYSTEM DATA FILE!(SDF) FORMAT 

Data in an SDF-formatted file is recorded in variable length images, with each image 
being preceded by a control word which specifies image length and type. Images are 
of two general types. 

(1) Control Images 

(2) Data Images 

Control images provide various file control information as is needed by the individual 
component processing the file. A control image is indicated by bit 35 being set in the 
control word preceding it. The initial image of every SDF-formatted file must be a 


label image which is defined by a 50g in bits 35-30 of the control word. The contro! 
word for SDF control images has the format: 


$1 $2 S3 S4 $5 S6 
where: 


c A unique code indicating what information is contained in the control image. 
The possible octal values of c are: 


040 — Bypass this image 
041 — Unique READS file label image 


042 — ASCII/Fieldata switch 
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043 — Special FORTRAN back space 

050 — Label image 

051 — Continuation of previous image 

054 — End-of-reel 

056 — Start of accounting information in print file 
057 — Output symbiont position marker 

060 — Print control image 

070 — Punch control image 

076 — Demand breakpoint EOF 


077 — End-of-file 


NOTE: 
All information in the label block (C = 041, C = 050) must be in Fieldata even though 
the file is ASCII. 
/ The length in words of the following image. 
ft Used only in label blocks and is the file type as follows: 
C — Symbiont card file 
F — FORTRAN library data file 
1} — Symbiont input file (created by @FILE control statement) 
‘P — Symbiont print file 
S — Symbolic element (generally created by SIRASM) 


p Used only in the label block of symbiont files and is the part number of the file 
(that is, a count of the breakpoints performed on the file). 


ct The code type of the following images (applicable only where C = 042 or 050): 
Q —  Fieldata 
1 — ASCII 


Any image in an SDF-formatted file whose control word does not have bit 35 set is a 
data image. The contro! word for an SDF data image has the format: 


where: 


n Used by each component to contain special information. For nonsymbiont files 
the n field extends through S6. 


STANDARD PROCESSOR CALL STATEMENT 
@PROCESSOR, options Sl-eltname, RO-eltname, SO-eltname 


where: 

S| -— source input 

RO — relocatable output 
SO — source output 


STANDARD PROCESSOR OPTIONS 


A -— _ Accept the results of processing even if errors are detected. In any case, 
do not error exit. 
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| — Initial insertion of a new source language input element from the control stream. 
The source language output (SO) parameter is never used, as the source language 
input (S!) parameter specifies the eltname to be given to the source language 


output. 
L — Produce the most comprehensive print listing available for this processor. 
N — Produce the most abbreviated print listing available for this processor. 
P — Specifies that source language output should be in Fieldata code. Identifies 


card image input, if any, as being in Fieldata. (Compare with Q option.) 


Q — Specifies that source language output should be in ASCII code. Identifies card 
image input, if any, as being in ASCII.. (If neither P nor Q is specified, the 
code type of the existing source language input element, if any, is used. Other- 
wise, Fieldata is assumed.) 


S — _ Produce a moderately comprehensive print listing. 


U — Update an existing source language input (SI) element to the next higher 
element cycle, thus saving any source language corrections that are currently 
being applied to the source language input element. 


W -— _ List correction lines at the head of the printer listing (this is feasible only 
for a two-pass processor). 


X — Take error exit if errors are detected, to inhibit further processing of the run. 


When the | option is not specified for processors that accept source language input, 
it indicates that the source language input (SI) eltname is an existing element from 
which the symbolic images are to be taken. To correct this source language input, 
directions must be given as to which of the existing images are to be deleted, and where 
any new images being furnished from the run stream are to be merged with the existing 
images. A special minus or hyphen character (—, which can optionally be changed to 
some other character such as + by including a card image which contains, in columns 
1-3, a —, a =, and the new character, as in: —=+) is normally used to identify cards in 
the source language input that direct these corrections by referencing decimal line 
numbers in the source language input element. These line numbers that are given on 
correction cards must be in ascending numerical order. To add images the correction 
card has —n to mean: insert after line n in the source language input element the 
noncorrection card(s) which directly follow this card in the run stream. To delete or 
replace an image or images, the correction card has —n,m which gives a range of line 
numbers to be deleted (such as —1,1 or —68,146) and directs that the noncorrection 
cards, if any, which directly follow this card in the run stream are to replace the 
deleted images. Any card images which are not preceded by a correction card are 
added at the very beginning of the element. 


Note about partial line corrections: 


In addition to the —n and —n,m correction card formats discussed earlier, —n,m— line 
range specification may be used for applying partial line corrections. For each card 
image in the existing element in the range n through m, there must be a corresponding 
parameter card following the —n,m— card. Parameter cards may be any of the follow- 
ing four types, where a slash (or any not otherwise used character) serves as a separa- 
tor: 


beginning-col-number ,ending-col-number/replacement-characters/ 
/existing-character-string/replacement-characters/ 
/existing-character-string/replacement-characters 
beginning-column-number/replacement-characters 


In the case of the second two parameters, the replacement characters are space filled 
out to the end of the card. For example, the parameter 73/ could be used to strip 
sequence numbers from columns 73 thru 80, leaving spaces in their place. In all cases, 
the information to the left of the separator identifies the portion of the card image 
to be removed. The replacement characters, if any, are inserted beginning at the left 
of this location. In the case of the first two parameters, where it may occur that the 
replacement characters do not fit into the space of the removed characters, the right 
portion of the existing image is right or left shifted as necessary. 


@label: 


A label is an alphanumeric field of one to six characters, the first of which must 
be an alphabetic. It is preceded by @ and terminated by a colon. Multiple labels 
may point to the same control statement. 


Unattached labels may stand alone in run streams. A @JUMP to an unattached 
label passes control downward in the run stream to the next control statement 
which can accept a label. 


Except where noted, a label may be used. 
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@ACOB[,options] S!-eltname, RO-eltname[,SO-eltname] 
Call the ASCII COBOL Sanguage processor. 


Options include the standard processor options and also: 


B — _ Double space listing. 

C -— List Library text from COPY verb. S or O option must also be present. 

D — Output allocation listing. 

E — Output all diagnostic messages. 

F — Output all diagnostics except Remark and Warning. Overrides E option. 

G — Compressed symbolic on input cards. 

H — Input cards contain sequence numbers in columns 73-80. 

J — Card input with compressed symbolic in columns 1-72 and sequence 
numbers in columns 73-80. 

K — Check sequence numbers in columns 73-80. 

M — _ tgnore MONITOR statements. 

O — Output object listing. 

R — Output cross reference listing. 

T — _ Reverse DISPLAY and DISPLAY-1. Reverse Comp and Comp-4. 

V —_ Indicates subprogram rather than a main program. 

Y — All listings written in Fieldata with PRINTS, instead of ASCII with 
APRINT$ (except for ‘W’ option correction lines). 

Z — Interpret compiler DEBUG and OPTIONS statements if debugging 


compiler used. 
@ADDL,options] eltname-or-filename 
Add to the run stream, at the location of this @ADD control statement, all of the 


data and/or control statements from a specified standard data file (SDF) format 
element or file. 


Options: 

D  — Allows the insertion of files or elements when operating under the 
DATA or ELT,D processors. 

—E — After the last image in the added data has been read, a subsequent ER 
READS request returns an end-of-file status, as if there had been an 
@EOF control statement at the end of the added data. 

tL — Use in demand mode only. Will list all control statements encountered 
in the added file or element at the demand terminal until! the run 
stream returns to the demand terminal input. 

P  — _ Print this @ADD control statement image. 


@ALGI[,options] Sl-eltname,RO-eltname[,SO-eltname] 
Call the ALGOL language processor. 


Options include the standard processor options and also: 


C — This is a program which uses the SIMULA extensions to ALGOL. 
F — _ Allow code in columns 73-80. 

M  — Increase compiler table by octal 010000. 

O — Compile array addressing in line, to speed up execution time. 

P — Inhibit printing of begin, end and block diagnostics. 

R — Remove subscript checking. 

T — Print the timing for shee and 2 of compilation. 

Z -— Delete the formation of runtime diagnostic information. 
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@ FASTRAND FORMATTED FILE @ASG CONTROL STATEMENT 


@ASG [options] filename,type/reserve/granule/maximum/placement,pack-id—1/.../; 
pack-id—n 
@@ 
Assign FASTRAND-formatted mass storage files. 


All parameters on the @ASG control statement are optional except filename. See 
facilities status bits in Section 4 for definitions of possible rejection or warning 
bit codes. 


Options for cataloguing: 


C — Catalogues file if the run terminates normally. If the file is freed 
prior to termination, the file is catalogued at that time. 


P  — Used with C or U option to catalogue file as a public file. If omitted, 
file is catalogued as a private file. 


R — _ Used with C or U option to catalogue file as a read-only file. The 
file can only be read or decatalogued. 


U — Same as C option except that the file is catalogued at run termination 
(regardless of the manner of termination beyond this statement). The 
@FREE control statement causes cataloguing prior to the termination. 


W — _ Used with C or U option to catalogue file as a write-only file. The 
file can only be written into. 


Options for catalogued files: 
A -— _ Specifies that the file being assigned is currently catalogued. 


D — Used with A option to delete catalogued file from the master file 
directory (decatalogue) if the run terminates normally, or when a 
@FREE control statement is encountered prior to run termination. 


K — Same as D option except that the file is decatalogued at run termina- 
tion regardless of the manner of termination. A @FREE control 
statement decatalogues the file prior to termination. 


Q -— _ Requests that this file assignment be honored even if the system has 
disabled the file. 


X — Used with A option to specify that this run is to have exclusive use 
of the file until the run has terminated or the file is released by a 
@FREE control statement or exclusive use is released via @FREE,X. 


Z -— _ Specifies that this control card is not to cause a hold condition. Con- 
trol will be returned immediately and the assignment will be rejected 
if a hold state would have resulted. 


Option for temporary files: 


T — Specifies that the file is to be assigned temporary and allows it to have 
a name the same as that of an unassigned catalogued file. 


Checkpoint/Restart Options for Control of Catalogued FASTRAND Files: 


B — Dumps the file as a part of any checkpoint. This option must be 
used with the E, H, or M options. 


E — _ Reload the file if any other run has referenced the file since the 
checkpoint. If no other run has referenced the file since checkpoint, 
the currently existing file is used with no reload. 


H —~ Reload the file only if no other run has referenced the file since 
checkpoint. If another run has referenced the file since checkpoint, 
the currently existing file is used with no reload. 

M — _ If a catalogued file by this name exists when reloading, make the 
reloaded file available to this run as a temporary file. If it does not 
exist, the file will be reloaded and assigned to this run as a catalogued 
file. 

type subfield: 


FCS— FASTRAND mass storage simulated in Unitized Channel (1106/1108) 
or Extended Storage (1110). 


F4 — FASTRAND-formatted mass storage simulated on FH-432 drum. 


Fi7— FASTRAND-formatted mass storage simulated on FH-1782. 
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F40— FASTRAND-formatted mass storage simulated on 8440 disc. 

F8 — FASTRAND-formatted mass storage simulated on FH-880 drum. 
F24— FASTRAND-formatted mass storage simulated on 8424 disc. 
F14— FASTRAND-formatted mass storage simulated on 8414 disc. 

F2 — FASTRAND mass storage, Model I! and Model III. 

F60— FASTRAND-formatted mass storage simulated on 8460 disc. 

F — FASTRAND-formatted mass storage, type independent. 


FASTRAND mass storage simulated on drum or disc has all the characteristics 
of a FASTRAND file except for sector padding on write functions. 


When space is not available for specified device type, another type is sub- 
stituted which satisfies the request. 


reserve subfield: 

An integer specifying the number of granules required by the file (not to 
exceed 262,143). This parameter should give a reasonable estimate of the space 
needed to create or update the file. The value used for a file update must 
include those granules already in use. 

granule subfield: 

TRK—One track (64 sectors = 1792 words) 

POS~—One position (64 tracks) 

If omitted, TRK is assumed. 

maximum subfield: 

Specifies the maximum allowable length (in granules) of the file. Permissible 
values are as for the reserve parameter. When specified, this parameter overrides 
the system standard maximum specified at system generation. If omitted, the 
reserve parameter value or system standard is used, whichever is larger. 
placement subfield: 

Placement may be any of the following forms: 

Is logical subsystem 

Islu logical subsystem and unit 

Is may be any of the letters A to Z. 

lu may be any of the numbers 1 to 15. The executive attempts to place 
files assigned to this run with different logical subsystems specifications on 
different physical subsystems. The same applies to logical unit specification. 
This is used to optimize 1/O operations. 

pack-ids: 

Specifies the removable disc packs required for the file. Pack-ids consist of 
from one to six characters of the set A~Z, O—9. The pack-ids for catalogued 
files are recorded in the master file directory and need not be specified on 
reassignments. Pack-id is applicable only to removable discs. If omitted (disc 
equipment is requested), fixed disc is assumed. 

General Notes: 

The device type of a FASTRAND-formatted file can be changed to a new type 
when extending a file. To make the change, the file must be reassigned as it 
was previously assigned, but with a different equipment code (device type). 


The following rules apply: 


(1) The file must be currently assigned to the run when the @ASG control 
statement with the new device type is submitted. 


(2) This feature does not apply to removable disc files. 
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@ MAGNETIC TAPE @ASG CONTROL STATEMENT: 


@ASGL,options] filename,type/units/log/noise/MSA-trans/unit-trans/format,reel—1/; 
reel—2.../reel—n,expiration-period. 
@@ 
Assign a magnetic tape file. 


All parameters on the @ASG control statement are optional except filename and 
type. The A,C,D,G,K,P,0,R,T,U,W,Y and Z options have the same meaning as 
on the FASTRAND-formatted @ASG control statement. 

The remaining options are: 

B — _ Binary (translation not required). 

E — _ Even parity (assumed when the | option is specified and translation 


is performed by software). Not recommended if the file manipulation 
is via Univac-supplied software. 


H — High density (800 FPI) tape (not available for UNISERVO 12/16 
nine-track if the hardware dual density feature does not exist on 
the unit). 


1 — Decimal (translation required). The translation of BCD to Fieldata 
on input and Fieldata to BCD on output is performed by hardware, 
if available. Otherwise, standard system conversion routines are used 
for translation. The E option is assumed when software performs 
translation. Software translate is not available on the UNISERVO 
12/16/20. 


— Low density (200 FP!) tape (not available for nine-track subsystems). 


M — Medium density (556 FPI) tape (not available for nine-track subsys- 
tems). 

O — Odd Parity (assumed). 

V — _ Density mode of 1600 FP! (UNISERVO 12/16/20 nine-track subsys- 
tems only). 


Options for tape labeling: 


F ~ Writes information on a labeled output tape to indicate that any 
reassignment of the tape requires only verification of reel number. 
Absence of the F option when creating a labeled output tape writes 
into the label blocks information which forces all subsequent assigns 
to use the same qualifier and filename that were used to create the 
tape. This causes reel number verification and confirmation that the 
correct file has been associated with the reel. 


J — Specifies that the reel loaded must be an unlabeled tape. 


NOTES: 


(1) In the absence of overriding mode options on seven-track tape assign- 
ments, the H and O options are assumed. For these assignments, mode 
option V is invalid. 


(2) For UNISERVO VI-C and VIII-C nine-track tape assignments, the H and 
O options are assumed. 


(3) For UNISERVO 12/16/20 nine-track assignments, the V and O options 
are assumed. For nine-track tape assignments mode options, B,E,1,L, and 
M are invalid. 


filename: 


The function and use of this parameter is the same as that specified for the 
FASTRAND @ASG control statement. 


type: 


Specifies that the @ASG control statement is for a magnetic tape device and 
identifies the specific type of unit required. Permissible entries for this param- 


eter are: 
T tape unit, type independent. 
Cc UNISERVO IV-C, VI-C, and VIN-C seven-track tape units. 
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CB UNISERVO IV-C, VI-C, and VIII-C seven-track units with hardware 
translate. 


cg UNISERVO VI-C and VIII-C nine-track tape units. 

U UNISERVO VI-C, VIII-C, 12 and 16 seven-track tape units. 

UB UNISERVO VI-C and VIII-C seven-track units with hardware translate. 
U9 nine-track tape unit, density independent. 

U9H nine-track tape unit, 800 FP! density. 

U9V nine-track tape unit, 1600 FP! density. 

2A UNISERVO I1-A tape unit. 

3A UNISERVO III-A tape unit. 

4c UNISERVO IV-C tape unit. 

6C UNISERVO VI-C seven-track tape unit. 

8C UNISERVO VIII-C seven-track tape unit. 

12 UNISERVO 12 seven-track tape unit. 

16 UNISERVO 16 seven-track tape unit. 

12N UNISERVO 12 nine-track tape unit. 

16N UNISERVO 16 nine-track tape unit. 

12D UNISERVO 12 dual density nine-track tape unit. 

16D UNISERVO 16 dual density nine-track tape unit. 

20N UNISERVO 20 nine-track tape unit. 

units: 

Specifies the number of tape units required, and may be integers 1 or 2. If 
omitted or a number other than 1 or 2 is specified, the executive assumes 
that one unit is required. 

log: 

Assigns a single letter indicating a logical channel. The executive attempts 
to assign all files with the same letter to the same physical channel and those 
with different letters to different channels. 

noise: 


Specifies an integer from 1 to 99 which overrides the standard system noise 
constant. If omitted, the standard system noise constant is assumed. 


MSA-trans: 


For UNISERVO 12/16/20 assignments only. Specifies the type of translator 
needed in the MSA. The MSA translator mnemonics are: 


EBCDIC —  Fieldata to or from EBCDIC 

ASCII —  Fieldata to or from ASCII 

XSEBCD -— _ XS-3 to or from EBCDIC 

XSASCI -— XS&-3 to or from ASCII 

OFF — Turns off translator if assign is from the master file direc- 
tory and file was catalogued with a translator specification. 

unit-trans: 


For UNISERVO 12/16 seven-track assignments only. Specifies the type of 
translator needed in the contro! unit. The contro! unit translator mnemonics 


are: 
BCD — EBCDIC to or from BCD 
DC — three eight-bit bytes converted to or from four six-bit tape charac- 


ters 
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OFF — Turns off translator if assign is made from the master file directory 
and the file was catalogued with a translator specification. 


format: 


For UNISERVO 12/16/20 assignments only. Specifies the data transfer format 
for the word-to-byte conversion in the MSA. The data transfer mnemonics are: 


Q -— _ quarter word 
6 -—_ 6-bit packed 
8 — _ 8-bit packed 


Quarter Word Format 


NOTE: 


Bits 35, 26, 17, and 8 are used for stop control on output operations and forced to 
binary 0 on input operations. 


6-Bit Packed Format 


6 Bytes 


NOTE: 


Bits O and 7 become binary 0 on output and are ignored on input, for each 8-bit byte. 
When translation is specified, bits 0 and 1 are not forced to binary O. 


8-Bit Packed Format 


Word 0 Word 1 


*Numbers on arrows indicate the order of byte transfer. 
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Word 1 Word 2 


reel: 


Specifies the identifier for each tape reel required. Each reel identifier is 
limited to six characters from the set A—Z and 0-9. Reels are used and 
catalogued in order specified. 

For temporary files, the reel parameter is not required, and the operator is 
requested to mount blank reels. If reel numbers are given on the @ASG con- 
trol statement, they are used in the given order. When additional reels are 
requested, blanks are used. 

expiration-period: 


Specifies the number of days that this file is to be retained. The maximum 
number allowed is 4,095 days. 


® WORD-ADDRESSABLE MASS STORAGE @ASG CONTROL STATEMENT: 
@ASG[,options] filename,type/reserve/granule/maximum ,pack-id—1/pack-id—2/.../; 
pack-id—n 
@@ 
Assign word-addressable mass storage and simulated word-addressable mass storage. 
Aj! parameters are optional on the @ASG control statement except filename and 
type. With the exception of the following differences, the parameters of this 
statement are basically the same as those for the FASTRAND-formatted mass 
storage @ASG control statement. 
Options: 
Same as for FASTRAND-formatted mass storage except that no distinction is 
made between file types except in the conversion of logical to physical ad- 
dresses. 
type subfield: 
Specifies that the @ASG control statement applies to word addressable drum 
format and names the specific type of recording equipment to be used. Per- 
missible parameters are: 
D Word-addressable storage, type independent 
D4 Word-addressable storage, FH-432 drum 
D8 Word-addressable storage, FH-880 drum 
D17 Word-addressable storage, FH-1782 drum 


DCS Word-addressable storage, Unitized Channel (1106/1108) or Extended 
Storage (1110) 


D14 Word-addressable storage, simulated on 8414 disc 
D24 Word-addressable storage, simulated on 8424 disc 
D40 Word-addressable storage, simulated on 8440 disc 


Use of the D entry is recommended since it allows the executive freedom in 
allocating file space. 


The use of the D14, D24, or D40 entry forces the executive to simulate word 
addressability which introduces additional overhead each time the file is 
accessed. 

Reserve: 

Entry is in number of words. 


Maximum: 


Entry is in number of words. 
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Word addressable files cannot be used as program files. The mass storage 
allocation routine attempts to satisfy word addressable drum requests in the 
same manner as it satisfies FASTRAND-formatted requests. 

@ ARBITRARY DEVICE @ASG CONTROL STATEMENT 


@ASG filename,type,pack-id or reel 
@@ 


Used for the assignment of special |/O devices, communications equipment, symbiont 
controlled devices, and online maintenance of all system peripherals. Symbiont 
devices and discs must be in a reserved state. 

All parameters in the operand field are required, except pack-id or reel. 

type: 


(1) The mnemonic definition of a class of devices; the executive selects the 
specific unit if more than one unit exists. 


(2) Absolute subsystem; the executive selects the specific unit. 
(3) Absolute subsystem/unit. 


For absolute subsystem assignment, the type parameter contains the subsystem 
number (1 to 127) in the format: 


Sxxx 


For absolute unit assignment, the type parameter contains both the subsystem 
number and the unit number in the format: 


Sxxx/Uyy 


If absolute subsystem and unit are used for communications devices, the unit 
specified must be the input rather than output or dial. 


@ASML,options] Sl-eltname, RO-eltname[,SO-eltname] 
Call the assembler. 


Options include the standard processor options given earlier in this section 
(where S causes both the source language input and octal output to be printed), 
and also: 


C Same as S option, except the octal output is not printed. 

D Same as S option, except that a double-spaced listing is produced. 

E Same as standard N option, except lines marked with error flags are printed. 
F Identify the relocatable output code as quarter-word sensitive. 


M Request that the assembler’s internal symbol and procedure sample table 
area be expanded by an additional 10240 (10K) words. The M, R, and 
Z options may be combined. 


O Print only the octal output. 


Request that the assembler’s internal symbol and procedure sample table 
area be expanded by an additional 5120 (5K) words. The R, M, and Z 
options may be combined. 


T Identify the relocatable output code as third-word sensitive. Compare this 
with the F option. 


Y Minimize unneeded print (for Teletype*). Do not print ‘*new’ or com- 
ments and shift PROC sample images to column 9. Must be used with 
other print option. 


Z Request that the assembler’s internal symbol and procedure sample table 
area be expanded by an additional 20480 (20K) words. The Z, M, and 
R options may be combined. 


@BRKPT[,option] generic-name[/part-name] 
@@ 


Close out the currently active file part as identified by generic-name, and start a 
new part as identified by part-name. The @BRKPT command may be applied 
equally to standard PRINT$ or PUNCH$ files, either EXEC or user-defined, or 
to read, print or punch alternate files. 


*Trademark of Teletype Corporation 
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Options: 


—E — Inhibits EOF positioning for alternate read files on magnetic tape. 
For input tapes, the @BRKPT command is normally used to pre- 
maturely terminate reading of the file; in the absence of the E option 
the input tape is positioned forward to the next EOF mark to allow 
reading of a subsequent file on the tape. The use of the E option 
avoids needless tape movement when the user is finished with the 
tape. 


L — Used to provide a method of stacking multiple files on a single mag- 
netic tape, and provide a label for each file by which it may be 
referenced on a subsequent @SYM command. The label is the part- 
name from the @BRKPT,L command(s). 


generic-name: 


Identifies the file part to be closed. May be either the name of a user defined 
file or the generic name PRINTS or PUNCH$ if it refers to a standard output 
file. if the generic-name refers to a standard output file, its contents are 
automatically queued for output at the appropriate peripheral device. If the 
generic-name refers to a user-defined file, the file is closed by writing an 
EOF mark. No attempt is made to queue user-defined output files (requires 
use of the @SYM control statement), and in the case of a magnetic tape file, 
the tape is positioned such that a new file may be started. 


part-name: 


Identifies the new file part. ts only required if the new part is a user-defined 
file. If the part being closed is a standard output file (generic-name is PRINTS 
or PUNCH$) and the new part is also to be a standard output file (not user- 
defined) the part-name field need not be included in the @BRKPT statement. 


(1) The only legal punctuation mark on a @BRKPT control! statement is a 
(/). A period following either the generic-name or part name is illegal. 


(2) A catalogued file must be used for a user-defined file if it is to be printed 
or punched later (see @SYM control statement). 


(3) tn normal demand operation there is no PRINT$ file and therefore, a 
‘@BRKPT PRINT$’ command is illegal unless the user has previously sub- 
mitted a ‘@BRKPT PRINT$/user-file’ command. 

(4) A user-defined mass storage file should be used as a part-name only once 
unless a means is employed to save the file data, since attempts to write 
multiple parts into such files causes overwriting of previous parts. 


@CAT[, options) operand 
@@ 


Directly catalog a mass storage or tape file in the master file Guectory, without 
first assigning facilities to the run. 


Operand: 

This has the same operand field as @ASG for mass storage, or @ASG for tape 
except that expiration period is not used. All parameters on the @CAT con- 
trol statement are optional except filename. 


Options: 


B,E,G,H,1,J,L,M,O,P,R,V, and W as described in magnetic tape and FASTRAND- 
format or word-addressable file @ASG. 


See facilities status bits in Section 4 for definitions of possible rejection or 
warning bit codes. 


@CHGL,options] eltname-or-filename[with keys] , 
eltname|[-or-filename[with keys] ] 


Call the FURPUR processor to: a) change the name of a program file element, or, 
b) to change a catalogued file’s name, modes and/or keys. 


Options for a) are A,C,O,R, and S as defined under @FIND. Any combina- 
tion of these options may be used. 


Options for b) are: 


P — _ set public mode. 
Q —--= set private mode. 
V —_ set read-only mode, clear write-only mode. 
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W -—_ set write-only mode, clear read-only mode. 


Z -— clear read-only or write-only mode (must not be used in conjunction 
with V and W options). 


@CKPAR L,options] filename.element 
@@ 


Establish a program checkpoint dump that may be used for restart at some future 
time. 


Options are P and T as defined under @CKPT. 
filename: 


Specifies the user-assigned FASTRAND-formatted file currently assigned to the 
run. 


element: 


Specifies the name to be given to the element created by the checkpoint. 
Only one checkpoint per element is permitted. 


NOTE: 


The @CKPAR control statement has no meaning within a run stream because 
there is no program executing at the time the statement is encountered. 


The error status codes returned by @CKPAR are displayed in the description 
of @CKPT. 


@CKPT[,options] filename 
Produce a checkpoint dump of this run. 
Options: 


P — The dump completion message and all error code messages are to be 
written to the console. 


T — Terminate this run after this checkpoint is taken. 


The specified filename must be assigned and may be either a tape or mass 
storage file which is catalogued public. While only the last checkpoint directed 
to a FASTRAND mass storage file is saved, all of a run’s checkpoints that are 
directed to a tape file are saved. 


The following are checkpoint error status codes (which appear in register AO 
if @CKPT is called via ER CSF$). They apply to complete and partial check- 
point as indicated in the table. 


Error Code Description 
(octal) 


Unrecoverable magnetic tape error.(2) 

Unrecoverable FASTRAND-formatted mass storage error. (1,2) 
Checkpoint file not assigned, filename specified for a partial! 
checkpoint is not a program file, or unable to assign checkpoint 


file if request was from keyin. (1,2) 


Checkpoint requested on illegal device type. (1.2) 


Read or write is inhibited on the FASTRAND-formatted check- 
point file. (1.2) 


Lost position on tape (other than checkpoint file). (2) 


Run has non-write-protected common bank. (1,2) 


The PCT is at its maximum size and cannot be expanded. (2) 


The run is already being checkpointed. (1,2) 


NOTES: 
(1) May occur during partial checkpoint. 


(2) May occur during complete checkpoint. 
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Error Code Description 
(octal) 
A program is executing in real time (for keyin only), or ESI activities 
are present or the run is demand, or the run has write enabled com- 
mon banks attached. (1,2) 
Format error. (2) 


User's program file is not assigned. (1) 


Checkpoint file is not large enough — I/O status of 22g status was 
returned. (1,2) 


Transparent request of run having no activities. (1) 


NOTES: 
(1) May occur during partial checkpoint. 
(2} May occur during complete checkpoint. 
@CLOSE L,options] filename,. . . 
This has the effect of a@MARK, followed by a @REWIND. 
Options: 
C — Continue. Do not error terminate, even if errors are detected. 
! — Rewind with interlock. 
@COBL[, options] Sl-eltname,RO-eltname[,SO-eltname] 
Call the COBOL language processor. 
Options include the standard processor options given earlier (where S causes 


only the symbolic input to be fisted, and L is the same as if the C,D,E,K,O,R 
and S options had been specified). Also: 


B — _ Ignore sequence number check. 

C — _ List matched names of CORRESPONDING data names. 

D — List data definitions, with qualification. 

E -— _ List detailed error diagnostics. 

F — Causes COB$PF file to be searched first when attempting to satisfy 


COPY statement. 


G —_ Input is compressed symbolic in columns 1-80. 
— Input contains sequence numbers in columns 73-80. 

J — _ Input is compressed symbolic in columns 1-72 and sequence numbers 
in columns 73-80. 

K — _ List all parts incorporated by the COPY and INCLUDE verbs. 

M — _ List source language COPYed. | 

O -—_ List octal output of final phase. 

R -—_ List cross references, excepting qualified names. 

T — Demand terminal use of ACCEPT and DISPLAY verbs is permitted. 

V  -—_ Indicates subprogram rather than a main program, and prevents genera- 
tion of a starting address. 

Y — Causes COBSPF file to be searched after source input file when at- 
tempting to satisfy COPY statement. 

Z — Source tine/relative address cross-reference. 

@COL CB,sentinel 


Permits the user to switch read mode to column binary. The @COL control 
statement is only valid when read from an onsite card reader. Three blank cards 
are needed after the @COL CB card. 
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Only the sentinel parameter is optional in the @COL CB control statement. A 
label is not allowed. 


sentinel: 


Specifies user-defined sentinel for terminating the nonstandard read mode data 
input stream. The sentinel may consist of from one to five characters. 


@COL Command 


Permits the user to switch to a read/transilate mode at the onsite 9000 card reader 
that is other than the system standard. 


Command specifies the mode to be used for the next, and succeeding card reads 
until a new @COL control statement (or a @FIN) is read. No sentinel is :eeded. 
The @COL control statement may be used at any point in a run stream or may 
precede the @RUN control statement if it is necessary to establish a new input 
mode for a specific card deck. 


The commands are as follows: 


1100FD Read 1100 cards (FD), send Fieldata images. 
9000F D Read EBCDIC cards, send Fieldata images. 
1100AS Read 1100 cards (FD), send ASCII images. 
9000AS Read EBCDIC cards, send ASCII images. 
ASCFD Read ASCII cards, send Fieldata images. 
ASCASC Read ASCII cards, send ASCII images. 


No blank cards are needed after these @COL control statements. 
@COPIN[, options] input-filename-or-eltname[,output-filename-or-eltname] 
This is essentially the reverse of @COPOUT, where elements that were stored on 


tape in @COPOUT (element file) format are added back into a program file on 
mass storage. 


Options: 
A,O,R — Same definitions as for @COPY, except that the input filename 
and S (or the filename portion of an input eltname) identifies a tape 


file. 
Cand V —_ Same definitions as for @COPOUT. 


When a particular element is named for @COPIN, only one of the A,O,R, or 
S options may be specified. 


@COPIN used without options must specify only filenames. This causes all 
elements up to the next end-of-file (EOF) mark on the specified tape file 
to be copied. 


If the second parameter is omitted, the element name in the first parameter 
(if any) is used as the output element name; the output file in this case is 
assumed to be TPF$. 


@COPOUTI, options] input-filename-or-eltname, output-filename-or-eltname 


Call the FURPUR processor to copy onto tape a whole program file, or individual 
elements from within a program file. 


Options: 

A,O,R — Same definitions as for @COPY, except that the output filename 

and S (or the filename portion of an output eltname) identifies a tape 
file. 

Cc — Continue. Do not error terminate, even if errors are detected. 

V — Copy only elements of the version name indicated in the first 


parameter. if no version name is given in the first parameter, 
copy only elements with no version name. If a version name is 
given in the second parameter, attach this version name to all 
copied elements. A format of filename. [/version] is used in each 
parameter. The A,O,R, and S options may also be used to limit 
the copying to elements of the specified type(s). 


If A,O,R,S, or V options are used on one or more @COPOUT control state- 
ments, a final @MARK should be done. 
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@COPOUT without options copies an entire program file to tape, and does 
an automatic @MARK operation. 


@COPY [options] input-filename-or-eltname,output-filename-or-eltname[,M-count] 


Call the FURPUR processor to copy a file; or to make copies of the elements in one 
program file, and add them to another program file. 


M-count is used with @COPY,M on a tape-to-tape copy and @COPY,B. 
Options: 


A — Used only with program files. If input and output eltnames are specified, 
copy a single absolute element into the output file, under the given 
output element name (if no output element name is given, the input 
element name is used). If whole files are specified, all nondeleted 
absolute elements in input filename are copied and added to output 
filename. 


B — Used with 1100 Series FORTRAN files only. Copy the number of 
files (FORTRAN) specified in M-count from the input file to the 
output file. The input and output files cannot both be on mass 
storage or both be tape files. 


C — Continue. Do not error terminate, even if errors are detected. 


F — Copy contents of one file into another file. Program and element 
files must not be copied. !nput file must be in SDF format. Input 
reading is terminated by the SDF EOF. Block size for tape files 
must be 224 words. When output is to magnetic tape, two hardware 
EOF marks are written following the file and the tape is positioned 
between the EOF marks. 


G -— This is used to save a copy of a mass storage file on tape (in which 
case the M option is also used to perform a @MARK operation). 
Files saved in this manner are also restored to mass storage by using 
@COPY,G. @COPY,G does track size transfers of data to or from 
mass storage, without regard to the file’s original format. 


| — Copy an SDF file, named as input filename, and add it to a program 
file as a symbolic element, specified as output eltname. 


M —_ Except as noted elsewhere under @COPY options, this is used without 
other options for copying ‘‘files’’ (see definition of ‘‘file’’ under 
@MOVE) from one tape to another, to specify that a @MARK is to 
be done after each ‘‘file’’ is written to the output tape. The third 
parameter on a @COPY,M command may be used to state the number 
of ‘‘files’’ to be copied, which is assumed to be one if not stated. 
@COPY,M stops if two adjoining EOF marks are encountered, which 
is interpreted as the end of the tape. 


N — Copy a tape containing an abnormal frame count to another tape 
file or to a FASTRAND-formatted mass storage file. 


QO — SameasA, except for omnibus elements. 


— The input and output filenames must be program files. This copies 
all nondeleted elements from one file and adds them to the other file. 


R — _ Same as A, except for relocatable elements. 
S — Same as A, except for source language elements, including proc 
elements. 


@COPY without options may be used with two mass storage files of any for- 
mat, to overwrite output-filename with the contents of input-filename. 


@CULLI,options] [ASMorDATA/stop-column(pos)] [,eltname-or-filename....] 
Call the CULL processor to produce an alphabetically sorted, cross-referenced listing 


of all symbols in a specified set of source language elements. A symbol may 
contain up to 12 alphanumeric or $ characters. 


Options: 
A —_ Exclude symbols beginning with an alphabetic character. 
C —  Condense the printout listing to fit on a 72-column page. 
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D — _ Reverse the normal rule for including symbols that begin with a 
number or $.(In DATA mode, where everything is normally included, 
this will cause these symbols to be excluded. In ASM mode, where 
numbers and the free-standing $ character are normally excluded, 
this will cause them to be included.) 


E  — _ Inhibit all page ejects. 


| — Used in ASM mode to add all the common assembler mnemonics 
for instructions, j-designators, registers, etc., to the exception table 
list. 


L — In addition to performing any requested CULL operations, list the 
source language text of every element being processed, and identify 
the images that were inserted in producing update cycles of the 
element. 


M — _ Reverse the normal meaning of the exception symbol list, and in- 
clude only the symbols which appear in this list. 


N — Used in ASM mode to reverse the meanings of the U,W, and X 
options, so that the symbols used as labels are included, but nothing 
else is. 

OQ -— _ Exclude all elements that are not proc elements. 

P —_ €Exclude proc elements. 

Q -— Used in ASM mode to cause symbols inside quote marks (which 


are normally excluded) to be included. 


S -— Print out the exception table list. 
U — _ Used in ASM mode to omit referenced labels. 
W -—_ Used in ASM mode to exclude all symbols that are used: anywhere 


as a label (which means that they are defined). 


X — Used in ASM mode to exclude all symbols that are used anywhere 
as a label that is followed by an asterisk * (which means they are 
external definitions). 


Y — Used in ASM mode to cause the W and X options to be ignored for 
elements not explicitly named in the @CULL eltname list. 


Z — Used in ASM mode to include source language elements which have 
a processor code of 0, meaning ‘‘unmarked”’ (see ER PFI$ — Section 
2). This is sometimes necessary for @ASM assembler source language 
elements which are either very old, or have been worked on by other 
processors. 


The CULL modes are ASM and DATA, where ASM is assumed if none is 
stated. The stop-column is the last column which is examined in scanning 
each image (symbols are truncated if they extend beyond this column). If 
the stop-column is not stated, it is assumed to be 40 (to exclude the com- 
ment field) in ASM mode, or 80 (the full card image) in DATA mode. 


(pos) is the number of positions to be reserved for @CULL’s scratch file. 
It is assumed to be two if not stated, and has to be a larger value than 
two only if the number of symbol references is expected to possibly exceed 
70,000. 


A list of eltname and/or filename parameters may be given. Otherwise, all 
source language elements in TPF$ are processed. 


One or more data cards may directly follow the @CULL control statement 
to provide an exception table of symbols to be excluded. As many symbols 
as will fit, separated by spaces, may be listed on each of these cards. 


In the listing for an ASM mode CULL, the line numbers where a symbol is 
defined are flagged with an * (or””, if the label itself was followed by 
an *). The line numbers where a symbol is used as a directive (proc call, 
instruction mnemonic, etc.) are flagged with a D. 


@CYCLE eltname-or-filename[,maximum-number-of-cycles] 


Call the FURPUR processor to set a new limit on the maximum number of 
cycles to be retained by a source language element or catalogued file. 


lf the number of cycles currently retained is greater than the new maximum, a 
new element is created with the necessary oldest cycles deleted. Deleting an old 
element cycle involves dropping only those card images that were marked deleted 
when that cycle was produced. 
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When a catalogued file is named, the number sets the maximum range of F-cycles 
for the file. The file specified must be in the master file directory. If n is O, 
the F-cycle series is deleted. If n specifies a new maximum less than the current 
range of F-cycles being retained, enough F-cycles of the file set (starting with the 
oldest cycles) are deleted to satisfy the new range. 


If the ‘maximum-number-of-cycles’ field is omitted, current cycle information is 
listed for the filename specified. 


@DATAL options] input-filename[, [output-filename] [,sentinel-not-exceeding-6-chars] ] 


Call the DATA processor to transfer source language card images into an SDF 


format file. 
Options: 
| — OQverwrite any existing information in input-filename with the source 
language images which follow in the run stream. The output-filename 
parameter is not used. 
L  —~ Produce a listing. 


Any file-name referenced on a DATA call statement must have been previously 
assigned to the run and/or catalogued. 


If neither the | option is on, nor output-filename specified, the L option is 
assumed, and input-filename is listed. 


DATA does not write a tape mark after output of a file to tape. 
@DELETE[,options] eltname-or-filename,... 


Call the FURPUR processor to mark an element in a program file as deleted, or 
to drop a catalogued file from the master file directory. 


Any combination of the options A, O, R, S and C may be used, as defined 
under @FIND. If neither A, O, R, nor S is used, one or more presently 
catalogued files may be named. 


@EDL[,options] St-eltname-or-filename[{,SO-eltname-or-filename] 


Cail the text editor processor to add new images, or modify existing images, in a 
source Janguage element or SDF format file. 


Options: 

A — _ An auto-recovery is to be attempted. 

B — _ Batch mode operation in demand environment. 
D — Demand mode operation in batch environment. 
E — _ Echo input lines. 


1 — A new element or file is to be built. Enter the editor in input mode. 
N — _ Enter editor in brief mode. 

P — Qutput is converted to Fieldata. 

— Output is converted to ASCII. 


Read file only — no corrections to be applied. 


c DVD YP 
| 


—  Anexisting element or file is to be updated. 


® ED Processor Commands 


COMMAND DESCRIPTION 


ADD name This command is used to add all or portions 
or of a file to the current file. The first form 
ADD name num1 num2 adds the whole file, and the second form adds 
lines ‘num1’ through ‘num2’ to the current 
file. The lines to be added are inserted at 
the end of the file unless a + immediately fol- 
lows the command in which case the lines are 
inserted following the current position within 
the edit file. The ‘name’ is the element or 

filename. 
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COMMAND DESCRIPTION 


APPEND Go to the end of the element or file and enter 
input mode thereby allowing new images to 
be inserted. 


AUTO num! This command specifies that an automatic save 
of the current file is to be performed in case 
of processor or system failure. The ‘num1’ 
specifies that the auto save is to be performed 
for every ‘num1’ input transaction. 


CASE UPPER CASE UPPER causes all input lines to be trans- 

CASE NORMAL lated to upper case. In CASE NORMAL mode, 
no translation is made. CASE UPPER is 
assumed for Fieldata files or elements. 


CCHAR char This command sets the continuation character. 
When an input line to the editor has this 
character in it, the editor assumes that the 
next line of input is a continuation of this 
current line. To return to the original con- 
tinuation character (set by the system), use this 
command with no ‘char’. 


CHANGE/string—1/string—2/ m G This command searches a specified number of 
or text lines for ‘string—1’ and substitutes 
C/string1/string2/ mG ‘string—2’ for it. The number of lines to be 
scanned is indicated by ‘m’. The global indica- 
tor, ‘'G’ changes all occurrences of ‘string—1’ 
in the range of lines. Any character besides 
G (or no character) changes just the first oc- 
currence. The ‘/’ (slash) may be any charac- 
ter which does not occur in ‘string—1’ or 
‘string—2' except a blank. If ‘m’ is omitted, 
1 is assumed. The user may change all sub- 
sequent occurrences in the file by using the 
word ‘ALL’ (abbr. A) where ‘m’ is specified. 


CLIMIT column number This command allows the user to set a limit 
on the number of columns which wil! be 
searched during performance of the change 
command. The default value is 132. 


CSF executive control statement This command is used to submit a control 
statement via CSF$. Only statements valid 
for CSF$ may be submitted. The control 
statement must start in column 5. 


CPT This command prints out the SUPs used so 
far in the present run. 


CPUNCH num1 num2 This command is used to punch parts or all 
CPUNCH num1 of a file at an onsite card punch. After the 
CPUNCH command is entered, a message as follows will 
be typed out: 
MSG? 
The line typed in will be sent to the system 
console before the cards are punched. 


DELETE num1 num2 This command is used to delete lines from the 

D num1 num2 text. The first form deletes lines ‘num1’ 

DELETE num1 through ‘num2’. The second form deletes the 

D num1 next ‘num1’ lines starting with the current 
one. 


DITTO num1 This command allows duplication of other 

DITTO num1 num2 lines in the file. The duplicated tines are in- 
serted at the present position in the file. The 
first form results in the one line at ‘num1’ 
being inserted in the present position. The 
second form results in all tines ‘num1’ through 
‘num2’ being duplicated at the present posi- 
tion. 
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COMMAND DESCRIPTION 


EXCH char octal number This command is used to allow input of charac- 
ters not represented in the keyboard character 
set. ‘char’ is the character which is to be 
used to stand for the number whose internal 
representation is ‘octal number’. When ‘char’ 
occurs any place in an input line it will be 
replaced by this character. An EXCH with no 
parameters disables this feature. 


EXIT This is the command used to take a normal 
exit from the ED processor. All the correc- 
tions will be applied to the designated file 
and a normal exit will be taken. 


FIND mask FIND searches for an image which corresponds 
exactly column for column starting at column 
1 with the ‘mask’. Transparent characters 
may be in the mask which will test suc- 
cessfully with any character in the column. 
The search begins with the line following 
the current one and proceeds until a match 
or end-of-file is detected. 


FC mask The FC command behaves in the same way as 
the FIND command except that al! occur- 
rences are flagged in the remainder of the 
file. 


1B string This command behaves exactly the same as the 
INSERT command except that the line is in- 
serted before instead of after the current 
line. 


INLINE number term-sub This command allows inline editing of a given 
line. Jf ‘number’ is blank, the current line 
is assumed to be the one to be edited. 
Otherwise the editor proceeds to line ‘num- 
ber’. The line will be printed out. The 
user can then enter editing information di- 
rectly below the line to modify it.  Fol- 
lowing are the editing characters to be used. 


| — The string following this command is 
inserted following the character im- 
mediately above the |. The string is 
delimited on the right by the termina- 
tion character ‘!’. 


R — _ The characters following the R will 
replace the characters immediately 
above them. A ! is required to 
terminate replacement. 


D —_ The characters in the line above are 
deleted between the D and the !. 


An alternate termination symbol may be 
specified as ‘term-sub’. This will remain in 
effect for this INLINE only. 


INSERT string This command is used to insert a line following 

| string the line presently pointed at by the editor. 
This new line will then be the point at which 
the editor is positioned. The string to be in- 
serted starts after the first blank following 
INSERT. If a ‘+’ immediately follows the 
command, the string may be input on the next 
line. If the command with no image is entered 
when not in EOF mode (see ‘ON’ command) 
the editor will switch to input mode. In EOF 
mode this simply results in the insertion of 
a blank line. 


INPUT This command directs the editor to enter a 
special input mode. In this mode everything 
which is typed in is inserted in the file until 
an exit from the mode is taken. Exiting from 
this mode ts accomplished by typing an @EOF 
when in EOF mode (see ON and OFF com- 
mands) or a carriage return when not. Tabs 
are recognized in this mode. 
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COMMAND DESCRIPTION 


LNPRINT numi num2 
LNPRINT num1 
LNPRINT! 

LNP 


LNQUICK num1 num2 
LNQUICK num1 
LNQUICK! 

LNQ 


LNSITE num1 num2 
LNSITE num! 
LNSITE! 

LOCATE string 


LOCATE quote-char string 
quote-char 


LC string 
LC quote-char string 
quote-char 


LCHAR char 


MAIL user-id 


MAXLINE number 


MOVE num1 
MOVE num? num2 


MSCHAR char 


ON special mode,...,special mode 
OFF special mode,...,special mode 


This command directs the editor to move to 
the last line in the file and stay in edit mode. 
The last line may not be altered at this time. 


This command behaves like the PRINT com- 
mand except that each line is preceded with 
its line number. Syntax is the same as the 
PRINT command. 


This command behaves like the QUICK com- 
mand except that each line is preceded with 
its line number. Syntax is the same as the 
QUICK command. 


This command behaves the same as the SITE 
command except that each line is preceded 
with its line number. 


This command is used to search the text for 
a given string of characters. The search be- 
gins at the line following the current line and 
proceeds sequentially through the text until a 
find is made or the end of file is encountered. 
The first form ignores multiple blanks in the 
images. The second form requires that the 
text image be exactly the same as the string 
within the two quote characters. 


LC behaves as LOCATE except that all oc- 
currences of the string in the remaining text 
are located. Just before each line containing 
an occurrence is typed out, the line number 
is typed out. 


This command sets the quote character for the 
LOCATE command. The default character is 
quote (‘). A non-input character will be 
assumed if ‘char’ is a blank. 


This allows the user to send messages to 
another user. The user-id is the original 
run-id of the person to whom the message is 
directed. The editor will then solicit 10 lines 
of input with: 

MAIL** 
If the desired message is to be less than 10 
lines, the mode can be ended by entering an 
@EOF. After the message is received by the 
designated person it will be deleted. 


This sets the maximum length to which a line 
may increase. If it is exceeded, the line 
will be truncated. The default is 80. 


This command performs the same operation as 
the DITTO command except that the original 
lines are deleted after the duplication has 
taken place. The syntax is the same as for 
the DITTO command. 


This command sets a character which will be 
translated to a master space when it is input 
in column one. If ‘char’ is a blank, no 
master space translation is available. 


This is the command to be used if the user 
does not want his corrections to be applied 
to the file on exit. The input file will re- 
main as it was at the beginning of the editing 
session, and the output file, if any, will not 
be produced. 


This command is used to define some special 
modes within the editor. ON turns the mode 
on, and OFF turns it off. The special 
modes which may be abbreviated to one letter 
are: 

QUICK — compress extra blanks 
out of all output to 
device. 
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BRIEF — do not echo corrected 
images for CHANGE 
and DITTO. 

NUMBER - -—_ precede each line print- 
ed out with its line 
number. 

PCNTRL — recognize and print 
print control images. 

DSPLIT — delete lines transferred 
by SPLIT command. 

XBRIEF — do not echo lines trans- 
ferred by SPLIT or ADD 
commands. 

SEQ — print sequence numbers 
when soliciting input. 

LOOK — look for mail after each 
command is executed. 

EOF — special mode where 
blank fines may be 
entered. INP command 
enters input mode and 
@EOF exits from input 
mode to edit mode. 
While in input mode 
blank lines may be 
entered. Also the 
INSERT command with 
no image following will 
enter a blank line. 

MEMORY — _ remember modes on 
successive executions. 

UNISCP — allow correct charac- 
ter placement = on 
UNISCOPE with the 
INLINE command. 

OPR string This command is used to send a message to 

OPR*™ string the system console. The first form sends the 
message ‘string’. The second form does the 
same, but also solicits an answer. The 
string may not be more than 50 characters or 
it will be truncated. 

PCN This command is used to enter a print 
control image into the file being edited. 
When the command is entered, the editor 
will solicit the image with: 

CONTROL IMAGE— 

This image can only be read when in a 
special mode set by the ON command. 
PLIMIT column number1, This command is used to set left and right 
column number2 limits respectively on the columns printed 
out by the PRINT command. 
PRINT num1 num2 This command is used to print out lines of 
PRINT num1 text. The first form prints lines ‘num’ 
PRINT! through ‘num2’. The second form prints 
P the next ‘num1’ lines. If the command is 
immediately followed with a + the printing 
starts with the next line instead of the cur- 
rent one (example: PRINT+3). The third 
form prints the entire file from the top. 
If no number or recognizable symbol fol- 
lows the command, a 1 is assumed and the 
present line will be printed out. 
PUNCH num1 num2 This command is used to punch paper tape 
PUNCH num1 for form Il paper tape input at a terminal 
PUNCH which has punch and read hardware. The 


syntax for this command is the same as that 
for the PRINT command. When the command 
is entered, the following response will be 
given: 
DEPRESS PUNCH ON 

The processor will then pause to allow the 
user to push the punch-on button on the 
Paper tape punch hardware. After pausing, 
the designated lines will be typed out 
which will cause the paper tape to be 
punched at the same time. Rubouts will be 
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COMMAND DESCRIPTION 


punched at the start and finish of the tape. 
The tape so produced can be used as normal 
form II input. 


QUICK num71 num2 
QUICK num1 
QUICK! 

Q 


This command prints lines with all nonsigni- 
ficant blanks omitted. ‘num1’ and ‘num2’ are 
the same as on the PRINT command. Plus 
(+) may also be used on the second form 
with the same meaning. 


RETYPE string 
R string 


This command is used to completely replace 
the current line with the string following the 
first blank after the command. A + may 
be used after the command with the same 
Meaning as with the INSERT command. 
RP number This command is used to set a repeat counter 
for the INSERT command. Any insertion 
will be repeated ‘number’ times. 


SCALE number 


This command causes a line to be printed 

out which can be used for column sensitive 

operations. The form of the line is: 
12345678901 2345678901 23456789012 
34567890... 

starting in column ‘number’. 


SEQ.id i,j This command causes sequencing to be in- 


serted in columns 73-80. The starting value 


is ‘i’ and ‘j’ is the increment. The id 
overlays the numbers from the left. 


SET tab1 tab2 tab3 ... tabn This command is used to set the tabs for the 
commands which allow them as explained 
above. As many tabs as desired may be 
designated. Each SET command redefines 
all previous tabs, and so a SET with no 
tabs clears the tabs. If no SET has been 
performed a default of 11,21,39,73 is as- 
sumed. 


SITE num1 num2 
SITE num1 
SITE 


This command is used to direct output to 
an onsite printer (PR). The meanings of 
‘num1‘' and ‘num2’ are the same as for 
PRINT except that if no numbers are given, 
the third form is assumed. After this com- 
mand is entered, a message as follows will be 
typed out: 

HDG? 
The line typed in will be used to head the 
onsite output. Periods must not be used in 
this header as anything beyond the period 
will not be printed. After the output is 
done, the following will be typed: 

MSG? 
The user should enter the information neces- 
sary to indicate where and to whom the 
output should be returned. 


SPLIT name 
SPLIT name num1 num2 


This command is used to build new elements 
or files from portions of a current file. The 
first form causes all the lines preceding 
the line currently pointed at to be repro- 
duced as the designated file. The second form 
causes lines ‘num1’ through ‘num2’ to be 
reproduced. An ‘!' immediately after the 
SPLIT command causes the whole file to be 
copied. 


STATUS special mode,...,special mode] This command is used to request the status 
of special modes set by the ON and OFF 
commands. If no special modes are specified, 


the status of all will be listed. 


TAB tab-char 


This command is used to specify which charac- 
ter is to be used as a tabulator character. 
This character is recognized on the INSERT, 
1B, and RETYPE strings and is recognized on 
all input when in the input mode. The 
character is not transmitted to the file and 
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COMMAND DESCRIPTION 


behaves just as a tab on a typewriter. If 
no character is specified, a semicolon (;) is 
the tab character. 


TCHAR char This command sets a transparent character for 
the FIND command. No char disables the 
feature. TCHAR BL resets it default of 
blank. 


This command prints out the date, time and 
cycle information and the name of the output 
element or file. 


TYPE processor-mnemonic Sets the processor type for symbolic element 
output. The processor mnemonics are: ALG, 
APL, ASM, COB, DOC, ELT, FOR, LSP, 
MAP, BAS, SSG and SEC. Octa! numbers 
may also be used instead of the mnemonic. 


This command is used to cause an element or 
file to be saved as if the U was specified 
on the control statement. This is used if 
the entry to the editor was made with an R 
option. 


These commands are used to position the 
editor at a desired line in the text. The 
first form directs the editor to line ‘number’. 
The second form directs the editor to move to 
the position current line plus number. The 
third form directs the editor to move to the 
position current line minus ‘number’. When 
the specified line is located, it is typed out 
if not in BRIEF mode, and modifications may 
be made to it. If it is desired to insert lines 
before line 1, O may be typed in. This will 
position the editor immediately before the 
first line. 


@ELT[,options} S!-eltname[,[SO-eltname] [,sentinel-not-exceeding-6-chars] ] 


Call the ELT processor to insert or update an element in a program file. @ELT,D 
is used to create run streams beginning with a @RUN for use with @START, or 
partial run streams for use with @ADD. 


Options include |, L, and U, as defined earlier under standard processor 
options; A, R, and S as defined under @LIST; and also: 


D -— Used instead of the S option to indicate that the source language 
input images following the @ELT control statement may include one 
or more control statements (@ in the first column) which should be 
transferred as data, rather than immediately processed as control 
statements. When the D option is used, all control statements 
documented in this manual (except @END and @ENDCL) that 
follow the @ELT statement are transferred, until an @END or @FIN 
is encountered. 


Pairs of @ELT,D and @END control statements may be nested by using a 
different sentinel with each pair. A sentinel is any string of one to six 
alphanumeric characters. 


The A and R options are used only with the | option, for introducing an 
absolute or relocatable element into a program file from card images in 
the run stream (see @PCH). 


Source language elements (denoted by @ELT,S or @ELT,D) may be updated 
using the same correction conventions as noted under @ASM. 


@ENABLE filename.... 

Call the FURPUR processor to remove a ‘‘disabled’’ flag from a catalogued file. 
@END [sentinel-not-exceeding-6-chars] 

Notify system that this is the end of control stream images that are to be trans- 


ferred as data by the previous @ELT,D or @DATA control statement. A label is not 
allowed. 
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@ENDCL 


Terminate mode established by @COL CB control statement. Three blank cards are 
necessary after the @ENDCL card. A label is not allowed. 


@ENDF 


Mark the end of the images for a file created by the @FILE control statement. 
A label is not allowed. 


@ENDX 


When encountered on an ER READ$ while in CLIST mode (see ER CLISTS$ — 
Section 2), will cause return with CLIST index of 77g and terminates CLISTS 
mode. A label is not allowed. 


@EOF [sentinel-character] 


When encountered on an ER READS, will give an end-of-file (EOF) return, which 
is useful for separating data in the control stream. The sentinel character may 
appear only in column 6. A label is not allowed. 


@ERS filename.,... 


Call the FURPUR processor to return to the system all FASTRAND-formatted 
mass storage granules allocated to a file. 


@FILE (not available for demand users) 


Create SDF-formatted mass storage or magnetic tape files while the input 
symbiont is reading the run stream. 


For each storage device, the format of the @FILE control statement is identical 
to the @ASG control statement for that device (except that the label field is not 
allowed). The file into which the images are placed may be either a FASTRAND- 
formatted or magnetic tape file. FASTRAND-formatted files may not be tem- 
porary files. The @F!ILE statement is valid only within a @RUN. 


@FILE control statement processing is terminated upon encountering an @ENDF 
control statement, a @FIN control statement, or another @FILE control state- 
ment. Data images and all control statements except @COL and its accompanying 
end sentinel are placed into the created file (the @COL contro! staternent and 
sentinel are processed immediately, and the file is marked when the mode switch 
is made). 


Separate files may be created by separate @FILE control statements. However, 
if the current @FILE is being written to tape and the next @FILE control state- 
ment has the same filename -and qualifier, the current file wil! be closed, 
end-of-file will be written on tape, and the second file will follow. Otherwise, 
a separate file will be created as specified on the current @FILE card. 


@FIN 
Terminate a run. 


_ This control statement is always processed. It cannot be passed as a data image 
under @ELT,D or @DATA. A label is not allowed. 


@FIND,option[s] eltname 
This is normally used prior to a single-element @COPIN, to position a tape file in 


@COPOUT (element file) format to the element within the file which is to have 
the @COPIN done on it. 


Options: 

A,O,R, —_ Indicates an absolute, an omnibus, a relocatable, or a source !an- 
orS guage element. 

Cc — Donot error terminate even if errors are detected. 


Prior to using @FIND, the tape must be positioned to the ‘’file’’ (where “‘file’”’ 
is as defined under @MOVE) in which the requested element resides. The 
filename portion of eltname is that of the tape file. 


@FOR [options] St-eltname,RO-eltname[,SO-eltname] 
Call the FORTRAN language processor. 
Options include ail of the standard processor options given at the beginning of 


this section where the N listing option is assumed if neither L,N, nor S are 
given. 
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@FREE[,options] filename 
@@ 


Release the physical facilities assigned to this run under the specified filename. 
Options may specify changing the characteristics of filename’s assignment. 


Options: 


A -—_ Release only the @USE-attached name specified in filename. Take 
no other action unless indicated by other options. 


B  — _ Release the @USE-attached name specified in filename. If this is the 
only @USE-attached name, do a normal @FREE of the file. 


D — _ Drop this catalogued file from the master file directory. In order for 
this to be accomplished, the file must be assigned with valid keys, 
if keys exist in the master file directory. 


E  — _ Sets the first file header in tape label of the current reel back to 
skeleton format to logically set the reel to a blank tape. 


1 — Inhibit cataloguing of a file that was assigned using @ASG,C or 
@ASG,U. 


R — Do anormal @FREE, but do not release any @USE-attached names 
(unless the A option is also used). Save all pertinent information 
to reestablish the assignment. 


S — Doanormai @FREE of the file but retain the physical tape unit. 


X — Remove this run’s exclusive-use lock from an assigned file. Take no 
other action unless indicated by other options. 


The action on a @FREE with no options specified is to release all @USE- 
attached names, and drop filename from the inventory of facilities assigned 
to the run. 


See facilities status bits in Section 4 for definitions of possible rejection or 
warning bit codes. 


@HDGL,options] [heading-text-not-exceeding-96-characters] 
@@ 


Specify a new heading to be printed at the top of each page of printed output, 
along with the print file’s cumulative page number, and the current date. 


Options: 

N — Suppress printing of the heading, date and page number. 

P — Begin page count at 1, instead of at the print file’s current page 
number. 

X —  Donot print data or page number. 


@JUMP label-or-nonzero-number 


Transfer contro! downward to a specified control statement in the run stream, 
bypassing any intervening control statements or data. 


The jump-to control statement is identified either by a label, or by a number 


which identifies it as the nth contro! statement following the @JUMP (ex- 
cluding control statements which do not permit a label to be attached). 


@LIST [options] eltname.... 


Call the LIST processor to produce an edited dump of one or more absolute, 
relocatable, or source language elements. 


Options: 

A,R,or — _ Identifies each element as absolute (A), relocatable (R), or source 
S language (S). !f A, R, or S is not given, S is assumed. 

O — Produce a straight octal dump, without editing. 


SE AE a a a I SL I IP A INL TT RE TES 


UP—7824 PAGE 1—27 
Rev. 1 UPDATE 


EXEC 8 PAGE 1~28 
Hw/Sw Sum UPDATE 


econ ne Re a SL 


@LOG message-not-exceeding-132-characters 
@@ 


Enter a message in the master run log. 


The semicolon (;) may be used only in its normal capacity, which is to signify 
card image continuation. The sequence space-period-space ( . ) also has its usual 
meaning of start of comment field. The message starts in the second column 
following the control statement name. 


@MAP[, options] Sl-eltname,absolute-eltname[,SO-eltname] 


Call the MAP processor (the collector) to collect a specified set of relocatable 
elements, and produce from this an executable program which is in absolute element 
format. 


Options include the standard processor options defined at the beginning of 
this section and also: 


B —_ The area of main storage occupied by this program need not be zero- 
filled by the loader prior to loading. Segments specified for indirect 
loading will not have their main storage areas cleared prior to loading. 
Any area acquired by MCORE$ will not be cleared. 


D  — Debug option. Provide diagnostic messages for what appears to be 
either over 177777g (65K) address fields, or errors in instruction 
formats. 

E — _ Inhibit the possible downward adjustment of D bank starting address, 


which is normally done automatically when the program’s last D 
bank address exceeds 177777, (65K). 


F — Mark the absolute output element as being quarter-word sensitive. 


R — -Merge all of the input relocatable elements into a single output relocat- 
able element, instead of producing an absolute element. External 
references to elements in the system relocatable library are retained 
as external references, unless the following source language statement 
is used: LIB SYS$*RLIBS$. 


T — _ Mark the absolute output element as being third-word sensitive. 

V —_ Assign all addresses for both the | and D banks, but then strip off 
the D bank code. Compare with Y option. 

X — If error is detected, terminate collection and exit ERR$. 

Y -—_ Assign all addresses for both the | and D banks, but then strip off the 
| bank code. 

Z — _ Do not prepare the diagnostic tables in the output absolute element 


which are used by @PMD (and other dump editors) to identify portions 
of the program by segment name, element name, etc. 


The method of collection performed is designated as either a ‘‘bank-named 
collection” or “‘bank-implied collection.” In a bank-implied collection, no 
banks are explicitly named and the collector generates one !-bank of all odd 
location counters and one D-bank of all even location counters. In a bank- 
named collection, the user specifically names all banks (which may number 
from 1 to 250) and can direct the placement of any or all location counters 
within each bank. Note that certain source language directives can only be 
used in bank-named collections. 


Here, listed alphabetically, are the most commonly used collector source lan- 
guage directives. These may start in any column, and may use comment fields 
headed by a space-period-space sequence. In those instances where no source 
statements are used, the collector includes all relocatable elements from the 
file TPF$ plus any elements in the file SYS$*RLIB$. which are able to 
satisfy remaining undefined external references. 


COR name-of-included-element 


This names an element in an absolute collection which is to have one or 
more instruction or data words changed at @MAP time. Any number of 
correction parameter cards may follow the COR card. The first parameter 
of each parameter card identifies a word address (relative to a location 
counter in the element) that is to be changed: 


rel-addr,location-counter-number 


The remainder of the parameter card identifies the replacement value. If 
this is a single-field number, it is assumed to be a full-word replacement. 


ect err 
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If this is two fields, each field may contain any one of three half-word 
replacements: 


externally-defined-symbol {+rel-addr-offset] 
rel-addr location-counter-number 
number 


If the replacement value is seven fields, the first six of these are the values 
of the instruction fields f, j, a, x, h, i, (leading zeros must be used to 
indicate that these are octal values), and the seventh field is the same 
format as the above half-word replacements or: 
rel-addr,location-counter-number ,name-of-an-included-element 


DBANK[,options] bank-name[,relationship-specification]} 


Used only in bank-named collection to specify the beginning of the source 
language defining the named bank. The allowable options are: 


C — _ control! bank 

D — dynamic bank 

E ~— _ bank prefers to be loaded in extended storage 
$E — bank must be loaded in extended storage 


M — _ initially based on main PSR 

P — _ bank prefers to be loaded in primary storage 

P — bank must be loaded in primary storage 

R —_ bank is read-only 

U —_ initially based on utility PSR 

V — assign all addresses, but strip off this bank’s code 

X — common bank (must be used with M or U options only) 


The relationship-specification, if present, must be one of the following 
formats. Name—n may be a bank-name, a numeric value, or a bank-name 
+ numeric offset. 


name—1 The start address of bank-name is the same 
as that parameter specified by name—1 


(name—1) The start address of bank-name is the next 
address (multiple of 01000) following 
name—1 parameter 


(name—1,...,.name—n) The start address of bank-name is the next 
address (multiple of 01000) following 
highest of name—1,...,.name—n banks. 


If no relationship is specified, bank-name starts at the next address (multiple 
of 01000) following the most recently defined DBANK or IBANK (if 
omitted on an IBANK statement). 


DEF externally-defined-symbol.... 


Specifies that the named externally defined labels are to have their names 
and locations saved in a table (in the absolute element) called ENTRYS. 
In an R-option collection, the DEF directive must be used to specify those 
externalized labels which are to remain externalized in the merged output 
relocatable element. 


ENT externally-defined-symbol 


Defines a program starting location (which must be in the main segment), 
to which control should be initially transferred. 


EQU undefined-symbol/value,... 


Equates a value to an undefined symbol. This value may be either a 
number or an externally-defined-symbo! [+rel-addr-offset] . 


FORM bank-name 
or 
bank-name«seg-name 


Used only in bank-named collections. Allows duplication of a portion 
of a program structure previously defined within the map without re- 
quiring repetition of the source language used to define that structure. 
Bank-name specifies the bank whose structure is to be duplicuted, and 
seg-name specifies the segment within the bank whose element inclusion 
structure is to be duplicated. 


IBANK[,options}] bank-name [,relationship-specification] 


see DBANK 
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IN eltname-or-common-block-name-or-filename [ ($lc-set)] ,... 


Explicitly names an element or common block for inclusion in the col- 
lection, relative to the positioning of all other elements and common 
blocks. When a whole file is named, all relocatable elements in the file 
are included. Common blocks named on IN directives do not have 
filenames attached to them. The ($ic-set) is allowed only in bank-named 
collections. 


LIB filename 
or 
filename(bank-name/$lc-set).,... 


Specifies a file as a library to be searched, prior to the search of 
SYS$*RLIBS. The file will be searched for elements not yet found, 
that were named on IN without a file name. If the LIB file has had 
an entry point table previously prepared by @PREP, it will also be 
searched to satisfy external references. 


The second format is allowed only in bank-named collections and specifies 
that the named location counter set for any implicitly included element 
from that file is to be placed in the main segment of the named bank. 


NOT eltname-or-filename 


Causes the named element, or all elements in the named file, to be excluded 
from the collection, such as in NOT TPFS$. (to prevent an automatic 
search of that file from being done). 


RSEG segname 


An RSEG is loaded starting at whatever address (within the program limits) 
which is in A2 on an ER LOADS. All instructions and data in an RSEG 
are collected in the | bank. 


SEG segname[+] [,relationship-specification] 


Specify the beginning of a new segment, in a program that uses segmenta- 
tion. The format of segname is a 1-12 character alphanumeric name 
(with the $ and — characters also allowed) which should not duplicate 
other element or symbol names in the collection. All elements, etc., 
named on IN directives will be located within the last segment that was 
named prior to the IN directive. Elements brought into a collection to 
satisfy undefined symbols will be located as far to the base of the segment 
tree as is necessary to ensure that it is at a common juncture of all 
referencing elements. If * follows segname, any jump to an externally 
defined | bank label within the segment will cause an indirect cal! on 
ER LOADS if necessary, to first load the segment (via SYS$*RLIB$. 
element IDL$). Allowable relationships: 


SEG segname segname immediately follows segment 
named on last preceding SEG directive 

SEG segname,name—1 segname starts at same address as name—1 
segment 

SEG segname, (name—1) segname starts immediately following 


name—1 segment 

SEG segname,(name—1,name—2,...,name—n) 
segname follows highest last address of 
segments name—1,...,.name—n. 


$lc-set 


Used only in bank-named collections. Specifies a location counter set 
via either a keyword or explicit naming as follows: 


$SALL include all location counters 

S$NONE include no location counters (used to 
create dummy or skeleton structures) 

$ODD include only odd location counters 

SEVEN include only even location counters 

$n4,N2,..-.4m include only those location counters speci- 
fied 

$ALLBUT,ny,N9,...N mp include all location counters except those 
specified. 


The user code in a program can reference the symbols FRSTI$, LASTI$, 
FRSTD$, or LASTD$, referring respectively to the program's first and last 
1! and D bank addresses. The collector will replace these symbols with the 
actual address values assigned. References may also be made to FIRSTS, 
LASTS, and BDI$. These will be satisfied by the first bank address, last 
bank address and bank descriptor index of the bank in which the reference 
is made. 
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@MARK[,option] filename... 


Call the FURPUR processor to write two end-of-file (EOF) marks at the current 
tape position, and then backspace over the second EOF. 


Option: 
C — Continue. Do not error terminate, even if errors are detected. 
@MODE L,options] filename [,noise/MSA-trans/unit-trans/format] 
Set revised mode options and/or noise constant for a tape file. 
Mode Options: 
B,E,H,1,L,M,O, and V as described in magnetic tape @ASG. 
Only those options specifically stated are changed. This is roughly equiva- 
lent to the action on an ER !0$ function (42g), which means that the file 
must be currently assigned to the run, and even if the file is catalogued, 


those revised mode settings are not saved in the master file directory. 


See facilities status bits in Section 4 for definitions of possible rejection or 
warning bit codes. 


@MOVE L,options] filename,number-of-EOF-marks 


Call the FURPUR processor to move a magnetic tape file over a specified number 
of end-of-file (EOF) marks. The tape is left positioned immediately following 
the last EOF mark encountered on a move forward, or immediately precedes the 
last EOF mark encountered on a move backward. 


Options: 
B — Move tape backward, instead of forward. 
C  — Do not error terminate, even if errors are detected. 


The data which may precede each EOF mark on a tape file is here referred 
to by the name ‘‘file’’, in double quotes. The use of @MOVE for positioning 
a tape from one “‘file’’ to another is described briefly by the following two 
examples. 


To move forward to the start of a ‘‘file’’ that is three ‘‘files’’ ahead of the 
current one at which the tape is positioned, @MOVE filename,3 is used. 


To move backward, to the start of a “file’’ that is three ‘‘files’’ behind the 
current one, requires the following two-command sequence: @MOVE,B 
filename,4 and @MOVE filename,1. 


@MSG[,options] message-not-exceeding-50-characters 


Transmit a message to the console operator. 


Options: 

C,i,H — Direct message to either communications console (C), 1/O con- 

orS sole (1), hardware confidence console (H), or system console (S). 
if C,1,H,S, (or N) is not given, S is assumed. 

N — Include this control statement in the run’s printer listing, but 
otherwise ignore it. @MSG,N functions like a comment card in 
the run stream; using any other options in addition to N is 
meaningless. 

W — Hold the run in wait status until a response is typed in by the 


operator. The response will be printed at a demand terminal. 
@NUALG[_ options] Si-eltname,RO-eltname[,SO-eltname] 


Call the NU ALGOL language processor. 


Options: 

B — List serial number and level number at the beginning of each 
block in the program during compilation. 

E — Required for compiling an external procedure. 

F ~— The compiled code is listed and punched into cards which are 


accepted by the assembler. 
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O,R — Remove subscript checking to decrease execution time of produc- 
tion programs. 
— Print the times for the four passes of the compiler. 
Suppress warning messages. 


— Suppress warning “This Variable Has Not Been Assigned a Value’ 


N < < aA 
| 


— Norun-time diagnostic information is prepared. 
@PACK[,options] filename.... 


Call the FURPUR processor to pack together the nondeleted elements of a pro- 
gram file, by rewriting the file and eliminating the deleted elements. 


Options: 

A -—_ Treat ail but absolute elements as deleted. 

O -— _ Treat all but omnibus elements as deleted. 

R -—_ Treat all but relocatable elements as deleted. 
S  — Treat all but source elements as deleted. 


@PCH,option([s] eltname 


Call the FURPUR processor to punch out onto cards a complete copy of a program 
file element, preceded by a properly formatted @ELT,! card. 


Options include A,O,R,S and C, as defined under @FIND. These may be used 
in any combination. And also: 


H —~ Used with S option causes sequence numbers to be punched in 
columns 73-80. 


The @ELT,| card that is prepared by @PCH has the same eltname as is 
specified above. (For a proc element, @PDP,! is punched instead of @ELT,I.) 


@PDP[,options] Sl-eltname,SO-eltname 


Call the procedure definition processor to produce program file proc entries suit- 
able for use by the @ASM, @COB, or @FOR processors. 


Options include A,|,L, and X, earlier described under standard processor 
options, and also: 


C -— COBOL proc element. Compare with F option. 


F  — FORTRAN proc element. If neither C nor F option is used, assembler 
proc is assumed. 


@PMD [options] name,rel-addr/location-counter,word-count,format] 
or [eltname/bankname,rel-addr/location counter, word-count,format] 
or (epname/bankname,word-count,format] 
or [part—1,part—2,...,part—n] 


Call the post mortem dump processor to dump all (or specified portions of) the 
segments of a program that reside in main storage at the time of program termination. 
Also dump the run’s program control table (PCT), if requested. 


Options: 

A — Dumps both the I-Bank and the D-Bank portions (if a parameter is 
used, it must be in the namelist following). 

C — Dump only those words that have been changed during program execu- 
tion. 

D — Dump D-bank portions. (If a parameter is used, it must be a name- 
list, as noted below). 

—E — _ Produce no dumps unless program terminates in error. 

\ — Dump I-bank portions. (If a parameter is used, it must be a name-list, 
as noted below). 

L — Dump elements that were included in the program from the system 


relocatable library files SYS$*RLIBS. (Since they do not contain 
user code, these RLIB$. elements are not normally included in @PMD 
dumps.) 
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P — Dump this run’s PCT, and also any @MAP-produced tables (such as 
the segment load table, which is used by ER LOADS) that may reside 
at the start of the terminating program’s D-bank, ahead of its main 
segment. The PCT consists of one or more 1000g-word blocks. These 
tables are dumped in octal format. 


X — Used only in conjunction with A, | or D options, to identify a 
name-list as an exception list, rather than an inclusion list. 


part: 

eltname eltname/bankname 

segname segname/bankname 
bankname eltname/segname/bankname 


eltname/segname 


NOTE: 


For programs collected with Level 23 and earlier levels of the collector, only 
the first two names may be used. 


The A, D, |, and X options are used with an optional parameter which is dif- 
ferent from that shown above, and consists of a namelist of one or more 1-12 
character names of segments, elements, or common blocks that were included 
in the @MAP of the program. When a segment is named, all of its elements and 
common blocks are dumped. Blank common may be explicitly referenced by 
its @MAP-given name, BLANK$COMMON. Whether or not the A, D, |, or 
X options are used, all parameters may be omitted. This means all active 
segments will be included. 


The parameters shown above may reference a single 1-12 character element, 
common block, segment, or bank. Rel-addr is a dump starting address (0 
is assumed, if this is not given), relative either to element location counter 
O (or any other location-counter that is stated here), or relative to the start 
of the block, in the case of a common block. 


Word-count is assumed to be the whole location counter or common block, 
if not stated. 


See explanation of ‘format’ under Dynamic Dump routines in Section 3. (User- 
defined formats may be given here within parentheses.) All output is 
single spaced, regardless of what ‘format’ spacing is specified. ‘D’, ‘S’ and 
user-defined formats are not applicable for C-option dumps. 


Several @PMD control statements may be used in succession, in order to 
separate the dumps of the terminating program into different parts. 


The only control statements which may intervene between the @XOT that 
calls the program: to be dumped, and the @PMD are: @JUMP, @SETC, @TEST, 
@ADD and @EOF. See comments pertaining to @RUN options N and Y. 


@PREP filename-1 ,filename-2....,filename-n 


Prepare an entry point table for a program file, for use by the @MAP processor 
in searching a LIB specified program file to satisfy undefined symbols. 


@PRT[,options} [name,...] 
Call the FURPUR processor to produce an edited listing of: 
(1) the entire master file directory; or 


(2) the master file directory entries for the specified file, account, or project; 
or 


(3) all catalogued files residing on a specified removable disc pack; or 

(4) the table of contents of a program file; or 

(5) the images of a source language element; or 

(6) all files currently assigned to a run. 
With no options or specifications, @PRT will list public files and private files 
with the same project-id as this run, ordered by projects. If an eltname is 
given, the S option is assumed. 
Options: 


C  — Continue. Do not error terminate, even if errors are detected. 
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D -—_ Display the names of all catalogued files currently residing wholly or 
partially on the named removable disc packs. Each name entry must 
have the format: pack-id/equipment code (e.g., PACK 1/F 24). 


F  — List the master file directory entry of only those files whose filenames 
are given in the operand field. 


{ — Display the names of all catalogued and temporary files currently 
assigned to the run. 


L — Used with @PRT,T in demand mode to get a long rather than a short 
listing from demand terminals. 


N —_ List the master file directory entry for that set of files whose account 
number is the same as this run’s. 


P  — _ List the master file directory entries for that set of files whose 
project-id is the same as this run’s. 


S — _ Used with an operand field of one or more source language eltnames 
to list symbolic elements. 


T — List the table of contents (TOC) of the program files whose filenames 
are given in the operand field. In demand mode, a condensed TOC is 
printed unless the L option is also specified. 


U — _ Display the current usage of the removable disc pack specified. The 
format is the same as for D. 


@QUAL qualifier 
@@ 


Define a qualifier name to be used with any filename references which have no 
qualifier, but precede the filename with an asterisk. 


@REWINDL,options] filename... 


Call the FURPUR processor to rewind a magnetic tape file to the loadpoint of its 
first reel. 


Options: 
C — Continue. Don’t error terminate, even if errors are detected. 
1 — Rewind with interlock. 
@RSPAR L,option] filename.element 
@e@ 
Restart a program at some previously taken checkpoint (by @CKPAR). 
Option: 


P — _ Display error messages on the operator’s console as well as in the 
master log. 


filename: 

Specifies the name of the assigned program file containing the checkpoint. 
element: 

Specifies the name of the element which contains the checkpoint. 


The error status codes returned by @RSPAR are displayed in the section con- 
cerning @RSTRT. 


@RSTRT[,[p] [/opt] ] run-id, [account] ,filename,checkpoint-number [,reel-number] 


Restart a run whose checkpoint dump was saved in the catalogued file filename by 
@CKPT. 


The normal options parameter is divided into two subfields, separated by a 
slash. The first subfield specifies priority from A to Z of the restarted run, 
and the second subfield contains the options P or T. (See @CKPT.) 
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Error Codes Description 
(Octal) 


Unrecoverable magnetic tape error. (2) 


Unrecoverable FASTRAND-formatted mass storage error. (1,2) 


Full cneckpoint not found on specified file or partial check- 
point not found on specified element. (1.2) 


File specified on restart request is on illegal device type. (2) 
The checkpoint file was not catalogued. (2) 

A facility for the program to be restarted cannot be assigned. 
In the case where insufficient units are available for tape as- 
signments, this error is not encountered since Restart will 


wait until! the required units are available. (2) 


Common bank used by checkpointed run no longer exists. (1,2) 


The checkpoint was not on the reel that was specified on the 
restart request. (2) 


The checkpoint is in error and is incomplete. (2) 


The next part of the checkpoint is not on the reel that was 
mounted. (2) 


Format error. (2) 


Restart of this run is already in progress. (1,2) 


Run requesting restart of a partial checkpoint has ES! activities 
or has write enabled common banks attached. (1) 


File specified on restart request was not assigned to run re- 
questing restart or element named on restart request was not 
found on specified file. (1) 


Transparent request on run having no activities. (1) 


NOTES: 
(1) May occur during partial restart. 
(2) May occur during complete restart. 
@RUNL,[p] [/opt] [run-id,account,project-id,run-time/deadline,pages/cards,start-time] 
Schedule a new run for initiation, and provide necessary accounting information. 
The normal options parameter is divided into two subfields, separated by a 
slash. The first subfield specifies priority from A to Z of the run, and the 


second subfield contains regular option letters. A label is not permitted. 


All parameters in the operand field are optional, with the exception that if 
deadline is given, the run-time must also be given. 


Options: 


B -— Treat the run input from a demand terminal as batch input and 
schedule the run as a batch run. 


C  — _ Terminate the run if the number of cards punched exceeds the cards 
estimate. 


E-L — Specifies, in 1000g word blocks, the initial size of the run’s program 
control table. E=two main storage blocks, F=three,...,L=nine main 
storage blocks. 


N — _ Inhibit all postmortem and dynamic diagnostic dumping. 

P — Terminate the run if the number of pages printed exceeds the pages 
estimate. 

R -—_ Restart run in the event of a recoverable system failure. 


— Process this run in sequence with the previous run submitted from the 
same peripheral device. This run will be held until! the previous run 
has terminated. 


ed 
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T — Terminate the run if the SUP usage estimate is exceeded. 
Y — Allow postmortem and dynamic diagnostic dumping of processors 


and programs in the system’s absolute library file SYS$*LIB$. 


The run-id cannot exceed six alphanumeric characters. RUNOQOO is used if no 
other run-id is given. 


The account parameter, which is used for billing purposes, cannot exceed 12 
alphanumeric characters (with the hyphen — character also allowed). If this 
is not given, OOOOOO is used. 


Project-id cannot exceed 12 alphanumeric characters (with the $ and — 
characters also allowed). If project-id is not given, O$Q$Q$ is used. 


The pages and cards are estimated output numbers. 


Deadline-time specifies when a run must be finished, and start-time specifies 
the earliest time the run can be considered for execution. Both parameters 
are specified in terms of elapsed time with run submission time normally 
used as initial time. !f both start-time and deadline-time are specified, start- 
time becomes the initial time. 


Both parameters have the format hhmm (hours,minutes). Prefixing the 
parameter with a D (Dhhmm) changes the meaning from elapsed time to 
time of day. 


The parameter run-time specifies an estimated SUP time in minutes. An ‘S’ 
prefixing the time specifies SUP time in seconds. Note, the deadline time is 
not honored if no run-time is specified. The format of run-time is 


mmmm 
where mmmm is minutes. 
@SETC[,options}] value[/j-designator-mnemonic] 
Store a value into T2 of the run condition word. 
Options: 


A -— Clears bit 30 of the condition word allowing a normal ERR$ 
termination. 


|! — Sets bit 30 of the condition word inhibiting run termination after a 
program error terminates. Normal processing continues. 


Allowable j-designator mnemonics are T2, $4, or S3. T2 is assumed if none 
is specified. 


@STARTI,[p] [/opt] ] name,set 
name,set,run-id,acct-id, project-id,run-time/deadline,pages/cards, 
start-time 


Initiate a run whose contro! stream is contained in an SDF format source language 
element or a data file. 


Two formats are provided for the @START control statement. Format 1 is 
used when all parameters from a prestored @RUN control statement are to 
be used. Format 2 is used when changing all or part of a @RUN control 
statement. 


The filename, or filename portion of eltname, specifies a currently catalogued 
file. 


All portions of the @START control statement, excepting the first two 
parameters, exactly duplicate the @RUN control statement, and are available 
simply for overriding priority, options, run-id, account, project-id, run-time, 
etc., which appear in the @RUN image at the beginning of the SDF format 
eltname-or-filename. 


A substitution is always made to replace the account number of the prestored 
@RUN contro! statement. The account number is taken from the @START 
control statement, if present, or otherwise the requesting run’s account 
number is used. 


The set-value is an octal number to be set into the started run’s condition 
word, which can be tested from within the run to determine which actions 
it is to take (see @TEST and ER COND$). 


The end of the started element or file is treated as an implied @FIN of the 
started run. 


ed 
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Any run initiated via @START from a demand terminal is scheduled as a batch 
run, with its printed output going to the primary onsite printer. 


@SYML,options] filename,copies,device,part-name-1/part-name-2/part-name-3/.../part- 
name-n 
@@ 


Direct the queuing of previously-created symbiont files to a specified device, or 
group of devices, for printing or punching. Also direct currently active primary 
output file (PRINT$/PUNCH$) to an alternate device. 


Options: 

A —_ Specifies all files on the tape are to be printed (punched) in the order 
they appear on the tape. The filename specified must be a tape file. 

C —_ Used with a punch file when a remote site name is given in the device- 
type-mnemonic parameter. 

D — When specified with the generic name PRINTS for filename, the 
current part of the PRINTS file is deleted at the time the file is closed 
and no output is produced. 

U — _ Inhibit @SYM’s normal action of decataloguing (deleting) filename 


after processing it for output. 


lf the filename is a user-defined file, it must be catalogued public and not 
currently assigned. If an internal-filename is specified, the associated file must 
be assigned to the run. Otherwise, filename must be a generic name (PRINT$ or 
PUNCH$). 


1 to 63 copies may be specified. If omitted one will be assumed. 


Device may identify a specific onsite device, a specific remote site, or a group 
of onsite devices (that is, the group might be all onsite punches, or all onsite 
1004 printers). Device group and remote site identifiers are defined at system 
generation. If omitted, the devices associated with the run initiation device are 
assumed. 


Part-names specify the labels of the symbiont file parts of a multifile tape to be 
printed or punched. If omitted, only the first part on the tape is processed. This 
parameter is not applicable to mass storage files. 


@TEST function-mnemonic/value[ /j-designator-mnemonic] ,... 


Skip the control statement which follows this statement in the run stream if the 
j-designated portion of the run condition word has a specified test relationship 
to a specified vatue. 


Allowable function mnemonics are TE, TNE, TG, or TLE. 


Value specifies a positive, octal value not exceeding 12 digits to be compared 
with that portion of the condition word specified by the j parameter. 


Any of the partial-word j-designator-mnemonics may be used, or W to indicate 
whole word. T2 is assumed if none is specified. 


If there is more than one parameter, and the test relationship of any of the 
parameters is true, a skip occurs. 


@USE 1-to-12-character-name,filename 
@@ 


Equate a unique, 1-12 character internal name to a filename, where filename is 
either another previous-@USE-defined internal name, or a full filename specifica- 
tion. 


The purpose of @USE is to resolve possible ambiguity among a set of files in the 
system which might differ only by qualifier or F-cycle, or to direct references in 
a control stream to a different filename than that which is stated. 


It is not necessary that filename be assigned. On a @FREE of a file, its @USE- 
attached names are normally discarded (see @FREE). See facilities status bits in 
Section 4 for definitions of possible rejection or warning bit codes. 
@XQT[, options] eltname 
Initiate the execution of a program which is in absolute element format. 
Options: 
Any set of option letters may be used. The user program may recover these 
through ER OPT$. (See Section 2.) The value is also in register AS when the 


program initially gains control. 
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If no eltname is specified, the most recent absolute element inserted into the 
run’s temporary program file (TPF$) is executed. If there are no absolute 
elements in TPF$, an automatic @MAP is forced of all the relocatable 
elements in TPF$ to create an absolute element, which is then executed. 


The following registers contain the special values described, when the program 
initially receives control: 


A4 — _ Program type, which is 4 for demand, 5 for deadline batch, and 6 
for regular batch. 


A5 — @XOQT (or processor call statement) options. This is the same in- 
formation as is furnished in AO by ER OPTS. 


R1 — Data in Fieldata, in the same format as AO has following a call on 
ER DATES. (See Section 2.) 
R2 — _ Time and Date, in the same format as AO has following a call on ER 
TDATE$. (See Section 2.) 
R3 — Total accumulated SUPs in units of 200 microseconds. 
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2. EXECUTIVE REQUESTS (ERs) 


ER FUNCTIONS AND FORMATS 


In the packet formats, parameters in regular type indicate information that must be 
supplied by the programmer; parameters in italics indicate information that the execu- 
tive returns in the packet. Brackets [ ] are used to indicate optional fields. 


Filename, when shown as a two-word field, is used to indicate an internal 12-character 
filename (left-justified and space filled). 


This section does not contain the communication or special purpose ERs. UN/VAC 
1100 Series Operating System Programmer Reference, UP-4144 (current version), con- 
tains the necessary information. 


ABORTS ER ABORTS 
(12g) 


Unconditionally terminate all activities, and then the run (if it is not a demand 
run). Do not provide register dumps or allow a postmortem dump. 


If contingency type 7 has been previously registered by an ER !ALL$ and an ER 
ABORTS is used to terminate all activities, a single new activity of the same type 
as the original program is created by the EXEC and it is given control with the full 
set of registers (contents not saved) at the program's contingency routine address. 


ACLIST$ L AO, list-designator 
(1419) ER _—ACLIST$ 


Allow the user to define his own set of ASCII control statements and register them 
with the executive. The ACLIST$ request is similar to the CLIST$ request. The 
list may contain a maximum of 62 six-character alphanumeric ASCI| control state- 
ment names. Analogous to the CLIST$ one-word terminators +O and —O are the 
ACLIST$ two-word terminators: +0100100100100100100100100 and 
+0137 137137 137137137137137, respectively. 


ACSF$ L AO, (image-length,image-addr) 
(140g) ER ACSF$ 


Submits ASCII control statements for interpretation and processing during program 
execution rather than from the run stream. 


The interpretation of parameters is identical to that for the CSF$ request. Maxi- 
mum allowed value for the image-length is 6019 words; 2119 is assumed if O is 


given. 
ACT$ L A0,activity-name 
(147, ) ER ACT$ 


Activate an activity that previously named itself through an ER NAMES. 
Activity-name is the one-word name returned on a NAME$ request. The activity 
making this request to activate another named activity does not itself have to be 
named. 


APCHCAS 
(774) 


ASCII punch control alternate. (See PCHCAS.) 


APCHCNS 
(75g) 


ASCII punch control. (See PCHCN$.) 


APNCHAS 
(73g) 


ASCII punch alternate. (See PNCHA$.) 


APRINTS$ 
(705) 


ASCII print. (See PRINTS.) 


APRNTAS 
(71) 


ASCII print alternate. (See PRNTAS.) 


SNS AE EASES UE ESSAI FPA SI ET TE EE TE ETAT ED 


UP—7824 PAGE 2-4 
Rev. 1 UPDATE 


EXEC 8 PAGE 2-2 
Hw/Sw Sum UPDATE 


Se a TE IE LP TT LE BE EI TEE a LIT OT IE I ES IED, 


APRTCAS 
(76g) 


ASCI! print control alternate. (See PRTCAS.) 


APRTCNS$ 
(74g) 


ASCII print control. (See PRTCNS.) 


APUNCHS 
(72g) 


ASCII punch. (See PUNCH$.) 


AREAD$ 
(1663) 


ASCII read. (See READS.) 


AREADAS 
(167g) 


ASCII read alternate. (See READAS.) 


ATREAD$ 
(170g) 


ASCII print and read. (See TREADS.) 


AWAIT$ L AO, (activity-id-mask) 
(134g) ER AWAITS 


Delay further execution of the requesting activity until all specified activities have 
terminated. 


Bits 1 through 35 of the activity-id mask correspond to activity id’s 1 through 35 


which were created via the FORK$ request. Bit 0 of the activity-id-mask is not 
used. 


AWAIT$ may not be used by the initial activity, since the activity which makes this 
request, and all of the activities referenced by this request, must have activity id's. 


BANKS L AO, (length address) 
(160g) ER BANKS 


Retrieves BDI and pertinent bit flags. 
The length parameter when added to the initial address parameter defines the 
highest relative address of the area for which the BDI is to be returned. If a zero 


length is specified, a value of one is assumed. 


A status is returned in AO in the following format: 


Bits O—11 The BDI (Bank Descriptor Index) 

Bits 12—14 Zero 

Bit 15 1 if dynamic bank 

Bit 16 1 if bank is used as D-Bank 

Bit 17 1 if common bank 

Bit 18 1 if defined as a D-Bank 

Bit 19 1 if bank is under utility PSR base (1110 only) 
Bit 20 1 if bank is write protected 


If AO = 0, the address range passed was wholly or partially outside the user's 
window. 


LXI,U  A0,1*/17 
ER BANK$ 


Where AO is set negative, the above calling sequence retrieves all currently active 
BDIs in AO and Al: 


AO: 
H2 — D-Bank BDI 
H1 — |-Bank BDI 


Al (if 1110 PSRU active): 
H2 — D-Bank PSRU BDI 
H1 — |-Bank PSRU BDI 


For 1108, A1 is cleared to zero. 
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CEND$ ER _- CENDS 
(100g) 


Notifies executive of completion of contingency processing. 


CLIST$ L,U AO,pktaddr 
(153g) ER _—CLIST$ 


Changes the operating mode of READS to allow reading control statement images, 
whose names are specified in the CLIST$ packet. 


The packet is a list of from 1 to 62 one-word alphanumeric (left-justified and space 
filled) control statement names, followed by a one-word list terminator of plus or 
minus zero, 


If the list terminator is plus zero, CLIST$ mode terminates when a control state- 
ment not in the list, other than @ADD or @EOF, is encountered. 


If the list terminator is minus zero (777777777777g) ali nontransparent control 
statements that are not in the list and which are not an @ADD or @EOF control 
statement are bypassed until an @ENDX or @FIN control statement is encountered 
which turns off CLIST$ mode. 


Each name in the list is assigned an index value which corresponds to its position, 
beginning with the number 1 for the first name. When a name in the list is en- 
countered in the runstream, its index is returned in bits 23—18 of AO by READS or 
AREAD$. A special index value of 63 (77g) indicates an @ENDX control state- 


ment. 
COM$ LU AO, pktaddr 
(10g) ER  COM$ 


These two instructions can be generated by the proc: 
C$OM _pktaddr 
Transmits an output message of up to 50 characters to the console display device. 
{f an input character count is specified, control is not returned until an answer is 
received from the operator. 


Packet: 


$2 $3 


$1 H2 
error- console- control : 
slate actual-input-char-count 


WORD 


0 
1 output-char-count 
aa (max. 50) Output-buffer-addr 

2 (cna BO) input-buffer-addr 
Console Class: Control bits: 
0 — System console Bit 20=1 indicates that the 
1 — 1/0 activity console console message and re- 
2 — Communications console sponse are in quarter-word 
3 — Hardware confidence console ASCII. Bit 20=0, Fieldata 
4-7 — Four additional message categories format is assumed. 


may also be used to direct messages 
to specific console devices. The 
class code for these categories may 
be defined for individual site appli- 
cations. 


Actual-input-char-count contains the number of input characters received. 


The error-code field contains a COM$ error code defined under contingency type 5 
(see Section 4). 


The above packet can be generated by the proc call: 


C$OMPK |[,console-class] output-char-count,output-buffer-addr [,expected-input- 
char-count,input-buffer-addr] 


COND$ ER _ COND$ 
(66) 


Places the run condition word in AQ. 
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The format of the condition word returned in AO is: 


T1 T2 T3 


error-condition-bits ah er 
value-set-by-@SETC | value-set-by-SETC$ 


Bit 30 — Inhibit ERR mode on ERRS terminations (set by @SETC,! and 
cleared by @SETC,A) 
26 — Last termination was an ABORT$ (not EABT$) 
25 — Last termination was an ERR$ 
24 - This run has had ERR$ terminations 
CRTNS ER CRTNS$ 
(35g) 


Notifies the executive that contingency processing is complete. Control is re- 
turned at the address (not address +1) specified in H2 of word 0 of the contingency 
packet. 


CSF$ L AO, (image-word-length,image-addr) 
(17g) ER _—CSF$ 


Submits a control statement image for interpretation and processing. 

The image must be in the identical Fieldata format, including the character @ in 
the first sixth of word 0, as it would have been if it had been submitted as a regular 
control statement in the input run stream. 

The image is terminated when a comment terminator of space-period-space is 
encountered or a space following the last allowable parameter field is encountered, 


or the image-word-length in the upper half of AO has been exceeded. 


Maximum allowed value for image-word-length is 40 words; 14 is assumed if 0 is 
given. 


The 15 control statements which may be processed via CSF$ are: 


@ADD @CKPT @RSPAR 
@ASG @FREE @RSTRT 
@BRKPT @LOG @START 
@CAT @MODE @SYM 
@CKPAR @QUAL @USE 


Control statement option letters, when used within CSF$ images, retain their 
normal definitions. 


When certain contro! statements are submitted, AO is returned containing status or 
error information. For facility statements (@ASG, @CAT, @FREE, @MODE, or 
@USE), when one or more bits of AO are set it indicates either that the request was 
rejected, or that it was accepted with one or more precautionary warnings. See 
Section 4 for facility status bit description. 


For a @START request, AO contains codes as follows: 


Request processed normally. 

— Request rejected due to improper run stream in file. 
— Request rejected due to file unobtainable. 

— Request rejected due to element unobtainable. 

— Request rejected due to filename not specified. 


PWN Oo 


For a @CKPT or @CKPAR request, AO contains: 


H1 H2 


checkpoint-number checkpoint-status-code 


See Section 1 for checkpoint status codes. 


cTs$ The calling sequence must be generated by the proc: 
(123g) C$TS _ tscell 


Clears a TSQ lock and, if activities are queued, activates the next activity. 


The parameter tscell is the address of a TS cell generated by T$CELL. C$TS clears 
the TS lock and inspects the queue (tscell,H2). If the queue is not empty, an 
Executive Request is made to remove and activate the highest priority non-C$TSQ 
activity from the queue. No Executive Request is executed if the queue is empty. 


C$TS accommodates normal one-level indexing (e.g., CSTS tscell,X,). Indirect 
addressing, index incrementation, use of the Execute instruction (EX), and in- 
struction modification are not supported. 


CS$TS operates regardless of TSQ registration. 
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CTSA$ The calling sequence must be generated by the proc: 
(124g) CS$TSA tscell 


Simultaneously clears a TS lock and removes an activity from a C$TSQ wait. 


The parameter tscell is the address of a TS cell generated by TSCELL. C$TSA must 
be used to reactivate an activity previously queued via C$TSQ. 


The C$TSA request clears the TS lock for tscell, then inspects the TS queue. If the 
queue is not empty, an Executive Request is executed which searches the queue for 
the first activity marked as having done a C$TSQ. If such an activity is found, it 
is eligible for reactivation. If no activities could be found on the queue, CSTSA 
operation is identical to C$TS. 


At most, one C$TSOQ activity is enabled for each C$TSA call, and a CSTSA done 
before an associated C$TSOQ is lost. 


C$TSA accommodates normal one-level indexing (e.g., CSTSA tscell,Xx). Indirect 
addressing, index incrementation, use of the Execute remote instruction (EX), and 
instruction modification are not supported. 


C$TSA operates regardless of TSQ registration. 


CTSQ$ The calling sequence must be generated by the proc: 
(122) C$TSO tscell 


Provides, in conjunction with C$TSA, selective activity synchronization and data 
protection. 


The parameter tscell is the address of a TS cell generated by T$CELL. C$TSQ, 
when used with C$TSA, provides an alternative to DACT$/ACTS for synchroniza- 
tion of activities which communicate via a common data area. The C$TSO request 
generates an Executive Request which deactivates the calling activity, places it on 
the TS queue associated with tscell (as if it had failed a TS on tscell), and marks the 
activity as having done a C$TSQ. The TS lock for tscell is then cleared, and action 
similar to C$TS is performed to reactivate any activities which may have been 
queued for failing a TS on tscell while this activity had it set. ; 


C$TSQ accommodates normal one-level indexing (e.g., C$TSQ tscell, X,). Indirect 
addressing, index incrementation, use of the Execute remote instruction (EX), and 
instruction modification are not supported. 


C$TSO operates regardless of TSQ registration. 


DACTS$ ER DACT$ 
(150g) 


Deactivates the calling activity, which previously named itself through an ER 
NAMES. 


lf another activity has already executed an ER ACTS$ specifying the activity call- 
ing DACTS, then no deactivation occurs and control returns immediately. 


DATES ER DATES 
(228) 


Places in AO and Al the current date and time in Fieldata decimal numbers. 


T1 T2 T3 


month (01 — 12) day (01 — 31) year (last 2 digits) 


hours (00 — 23) minutes (00 — 59) seconds (00 — 59) 


AO 


Al 


EABTS ER EABTS 
(26) 


Identical to ER ABORTS except that a register dump is provided and any @PMD 
request is processed. 


ERRS ER ERRS 
(40g) 


Error terminates an activity, or, in the case of the last executing activity, error 
terminates a program. 


EXITS ER EXITS 
(115) 


Terminates an activity normally or, in the case of the last executing activity, ter- 
minates a program normally. 
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EXLNK$ ER EXLNKS 


(173g) 


Exit from a re-entrant processor (REP). Control is returned to the caller of the 
REP, which may be either another REP or the main program. 


FACILS$ LU 
(114g) ER 


AO, pktaddr 
FACILS 


Obtain in words 2 through 8 of the FACIL$ packet the external filename, the 
qualifier name, and the facilities assignment information that are associated with 
a particular internal filename. 


WORD $1 
internal-filename 
: 
6 equip-type 
7 Ea (equipment type dependent) 
8 


Equipment Type: 


Og — No equipment assigned 30g FASTRAND mass storage, 
to filename or no find model II or {11 or 8460 
1g — UNISERVO VIII-C 31g Not Used 
7-track 32g FASTRAND mass storage, 
2g — UNISERVOVI-C, simulated on FH-432 
7-track 33g FASTRAND mass storage, 
3g — UNISERVO VIII-C, simulated on FH-880 
hardware translate 34g FASTRAND mass storage, 
4g -— UNISERVO VI-C, simulated on FH-1782 
hardware translate 35g 8414 disc or 8424 
5g — UNISERVO VIII-C, 36g 8440 disc 
9-track 373 FASTRAND-formatted 
6g — UNISERVO VI-C, unitized channel storage 
9-track 403 Card reader and punch 
73 — UNISERVO VI-C, 41g Not used 
10g — UNISERVO VI-C, 42, 0920/0926 paper tape 
hardware translate 438 Not used 
Tig -— UNISERVO 12 44, High-speed printer (751) 
12g ~— UNISERVO 16 453 758 multiple high-speed 
13g -— UNISERVO 12, 9-track printer subsystem 
14g — UNISERVO 16, 9-track 46, Not used 
15g — UNISERVO 20, 9-track 478 92/9300 subsystem 
16g — UNISERVOIII-A 50g 1004 subsystem 
17g — UNISERVOII-A 51g Not used 
20g — FH-432 70g CTS 
21g — FH-880 71g WTS 
223 — FH-1782 72g CTMC 
23g — Word addressable mass 73g C/SP 
storage simulated on 778 Nonstandard device 
8414 or 8424 disc 
24g — Word addressable mass 
storage simulated on 
8440 disc 
25g —  Unitized channel storage 


The three classes of facilities for which ER FACIL$ is most commonly used are 
tape (for the current equipment types, the code range is 1g to 17g), word-ad- 
dressable drum (20g to 27g), and FASTRAND-format mass storage (30g to 37g). 
Words 6 through 8 of the FACILS packet for these three classes are as follows: 


Magnetic tape: 


WORD S1 $2 $3 $4 T3 
6 equip-type hails oe absolute-f-cycle 
7 ny @ASG-option-letter-bit-mask 
8 


total-reel | logical noise mode-setti 
count channel | constant re 
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File mode settings: 


Bit24 — Word addressable drum 
25 — _ Reading inhibited (can be set by @ASG,W) 
26 — _ Writing inhibited (can be set by @ASG,R) 
27 — _ Needs write key 
28 — Needs read key 
29 —-— _ Exclusively assigned file 


Unit-count is the number of tape units (1 or 2) which are physically assigned to 


this file. 

WORD 7 

Bit35 — _ If set, system has tape label checking in progress 
34 — _ If set, file assigned as temporary file 
33 —_ If set, assigned unit is downed 


Mode-settings: All tape units except UNISERVO 12/16/20 


Bits 10 and 11: O02 — No translation required 
01 — Software translation 
102 — Hardware translation 


Bits 12 and 13: O02 — Low density 
102 — Medium density 
112 — High density 


Bit 14: Oz — Odd parity 
lz — Even parity 


Mode-settings: UNISERVO 12/16 only: 


7-track 
Bits set: 9-8 Set to mode set for hardware 
10 Not used; must be zero 
11 Control! unit translator 
12 Parity (0 — even; 1 — odd) 
13 Data converter (0 — on; 1 — off) 
14 Medium density (if 15 and 14 are 0, it indicates low density) 
15 High density 
16 6-bit packed MSA data transfer format (if 17 and 16 are O, 
indicates quarter-word MSA transfer) 
17 8-bit packed MSA data transfer format 
Mode-settings: UNISERVO 12/16 only: 
9-track 
Bits set: 9-8 Same as 7-track 
10 Same as 7-track 
11 Density 10—1600 FPI; 1—800 FP! 
13-12 Not used; must be zero 
15-14 Must be set to mode set for hardware 


17-16 Same as 7-track 


Word Addressable Drum: 


WORD $1 $2 $3 $4 T3 
7 il @ASG-option-letter-bit-mask 
8 word-length-of-assigned-area 


File mode bit settings are identical to that for tape. Granularity is O for track, 
nonzero for position (a position is 64 tracks). 
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FASTRAND-Format Mass Storage: 


WORD $1 $2 $3 S4 T3 
7 ee @ASG-option-letter-bit-mask 
8 initial-granules-reserved-on-@ASG | max-granules-specified-on-@ASG 


File-mode bit settings and granularity are the same as for word addressable drum. 


FACITS L,U AO, pktaddr 
(143) ER FACIT$ 


This request is identical to the FACIL$ request except that an additional packet 
word must be furnished, into which additional facility information for tape or 
FASTRAND-format mass storage files is placed. 

Word 9 for tape: 


T1 $3 S4 and S5 S6 


it- : 
subsystem-number pid alternate-subsystem alt-unit 
number 


Subsystem and unit numbers are for each tape unit assigned. 


Word 9 for FASTRAND-format mass storage: 


H1 H2 
highest-track-written highest-granule-assigned 


FITEMS LA AO, (pkt-length,pktaddr) 
(32g) ER _— FITEM$ 


Provides a method to obtain a variable amount of information on file or facility 
assignments. 


Packet: 
WORD 
; internal-filename 
: filename 
6 
{ device dependent 
12 


An internal filename (left justified and space filled) must be placed in the first two 
words of the information packet. 


The remaining words of the packet are filled as a result of the FITEMS request. 


The minimum packet length is nine words; the maximum packet length is depen- 
dent upon the equipment type. (For detailed information on the variable portion 
of the packet, see the UN/VAC 1100 Series Operating System Programmer Refer- 
ence, UP-4144 (current version), Section 7.) 


Equipment Length 


Word addressable mass storage, 11 
arbitrary devices 


Whole unit mass storage, 9 
communications devices 


FASTRAND mass storage 11 
Magnetic tape, removable disc 13 


If the pkt-length is 0377777g, the maximum amount of information allowable for 
the equipment type is transferred to the packet. If the pkt-length given is less than 
nine or greater than the maximum for the equipment type, only seven words are 
transferred to the packet and an error status is returned in register AO (see fol- 
lowing). 
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Rejection of the FITEM$ request occurs only if the relative packet address 
specified in the request packet is invalid; that is, the address falls outside the user's 
bounds, or the span of the FITEM$ packet violates the user’s bounds, or the file- 
name specified was not assigned to the run. If an invalid filename is encountered, 
the equipment type cell is zeroed and WORD 1 of the filename is cleared. 


The status codes (returned in $1 of register AO) applicable to F!TEM$ requests are: 


1. — The requested packet length exceeded the allowable maximum. 

2 — _ The requested packet length was less than the allowable minimum. 
FORKS L AO, (parameter-word) 
(13g) ER FORK$ 


Registers and initiates a concurrent program activity. 
Parameter-Word: 
H2 


$1 $2 $3 


RT-priority, which must be zero if the program is not already real time, specifies 
a real-time switching level priority (2—35) for the new activity. 


Activity-id is optional. If given, it is a number from 1 to 35, and must be different 
for each separate forked activity that is initiated. 


Registers specify what set of registers shall be provided for the new activity (these 
registers will be initially loaded with the contents of the corresponding registers of 
the calling activity): 


0 Minor set (X8—X11, AQ—A5, R1—R3) 
1 Major set (all X, A and R registers except RO, XO, A15+3 and A15+4) 


IALL$ L AO,packet 
(101) L A1,(extended mask) (For TYPE above 14g) 
ER 1ALL$ 


Notify EXEC to allow user program to capture its own error and other contingency 
interrupts (only types specified in the [ALL$ packet selection-mask). 


Packet: 


T1 $3 H2 


Selection Mask-Bit Settings for Program Contingencies: 
(A1 meaningful only if selection mask in AO is zero) 


Contingency Bit Set Bit Set 
Type (Octal) AO Al Contingency 


IHegal Operation 

Guard Mode or Undefined Sequence 

Floating-Point Overflow 

Floating-Point Underflow 

Divide Fault 

Restart 

Abort 

Console Keyin 

Test and Set (Real Time Only) 

Error Mode 

Inter-Activity Interrupt 

Breakpoint Interrupt (UNIVAC 
1110 only) 

CAU/Storage or GRS Parity 
(UNIVAC 1110 only) 


2 
3 
4 
5 
6 
7 
8 
9 
0 
1 


— —) 


— 
NO 


Contingency Application: 


0 -—_ Entire program 
1. — Only the calling activity 
2 -—_ Set by real-time program for ESI activities 


Contingency types 1 through 5, 14 and 15 result from actual hardware interrupts. 
Contingency types 6, 7, 11, and 12 result from the executive generated pseudo 
interrupts. 
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On the UNIVAC 1108, arithmetic fault (types 3, 4, 5) A-register clearing on stan- 
dard action is done by examining the a-field of the offending instruction. No 
clearing occurs if an Execute remote (EX) instruction was used to execute the 
offending arithmetic instruction. 


On the UNIVAC 1110, the value of PSR bit D20 determines the action taken for 
arithmetic faults. 


D20 Value Standard Action 
1 Action is fully compatible with the UNIVAC 1108. 
0 Interrupt never occurs. The appropriate arithmetic result 


registers are cleared and instruction execution proceeds in 
line. Register clearing is done if the offending instruction 
occurred via Execute (EX) instruction. 


When the user program registers contingency routines to handle one or more of the 
arithmetic faults (types 3, 4, 5), D20 must equal 1 in order for the interrupt to 
occur on the 1110. 


For UNIVAC 1110 operating systems on the occurrence of a guard mode, illegal 
operation, breakpoint or undefined sequence interrupt, the Jump History Stack 
will be captured and saved in a dedicated area of the user’s Program Control Table. 
The user may examine this history via ER PCT$ or LIJ/LDJ to the PCT bank. 


Following an interrupt or pseudo-interrupt, control passes to third word of the 
contingency routine, whose address is specified in the |ALL$ packet. The executive 
stores the following information into the first two words (parameter area) of the 
contingency routine: 


WORD S1 $2 $3 H2 
0 error-type | error-code } cont-type reentry-address 


.._ |ER packet address or H7? of status 


Reentry-address is the address of the offending instruction or in the case of 
asynchronous contingencies, the address of the last instruction executed before 
detection of the error or other condition causing the interrupt. Contingency types 
are as noted above. 


Status bits are applicable only for Guard Mode and Undefined Sequence Interrupts 
on UNIVAC 1110 Systems. 


ER packet addr is applicable only for !/O and console error types. It also contains 
H1 of the status word if an undefined sequence interrupt occurred (UNIVAC 1110 
only). It may also be used on non-l/O error mode contingencies to contain infor- 
mation applicable to the error. 


Contingency type 10 (IINT) sets the error type field (S1 of word 0) to 1 for onsite 
\{ keyin, or 2 for demand @@X C keyin. 


The other parameter fields shown above are used only with contingency type 12, 
and only where relevant. The error types and error codes for contingency type 12 
are discussed in Section 4. 


Word 1 is used for auxiliary contingency information in some cases. 


Ns ER 1$ 
(275) 


Provides a means to define the activity which is to accept any unsolicited console 
input directed to the program. 


The activity executing the II$ request is deactivated as for a DACT$ request. 
However, the activity need not be named. If named, it may be reactivated using an 
ACT$ request; and if it also has the inter-activity interrupt contingency registered, 
it may be activated via an INT$ request. An I!$ request when an I!$ activity has 
already been defined for the program is not allowed. 


Unsolicited console input of up to six characters in Fieldata is stored (left-justified, 
space filled) in the activity’s AO register, and the activity is activated. 


After activation (by either ER ACT$, ER INT$ or console input), the activity is no 
longer defined as the unsolicited console input activity. The same activity or some 
other activity must execute another I1$ request to redefine the unsolicited console 
input activity. 


The console input activity is also activated by the remote terminal @@X C keyin. 
Since no input is actually received, register AO is space filled. 
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INTS$ L A1,parameter 
(33g) L A0,activity-name 


10$ 
(1g) 


ER INTS 
Asynchronously interrupts a named activity. 


The named activity specified in AO will be interrupted and given an activity in- 
terrupt contingency (type 13g). The activity interrupt contingency must be 
registered for the interrupted activity, either as a program or an activity con- 
tingency. Otherwise, the request will be ignored. If the activity to be interrupted 
cannot be found, the caller will be terminated in error with an error type 04 and 
error code 032. The activity calling INT$ need not be named. 


The interrupted activity will be reactivated from an AWAIT$, DACT$ or II$ state 
if necessary. In this case, the error address in the contingency packet will point 
one location before the AWAIT$, DACTS$ or II$ call, so that recovery may be done, 
as usual, by returning to the error address +1. In all other cases, except jumps, the 
reentry address points to the last instruction executed. If the last instruction 
executed was a jump, the reentry address points to one location before the destina- 
tion address for the jump. 


lf the interrupted activity is in a TWAITS, the time will be allowed to expire. 
Multiple INT$ requests for the same activity will be queued and processed serially. 


The contents of A1 will be placed in word 1 of the contingency packet. 


L,U AO,pktaddr 
ER 10$ 


These two instructions can be generated by the proc: 
1$O pktaddr 
Requests an operation on an I/O device as specified in the function field of the 1/0 


packet. Control is returned immediately to the executing program, without waiting 
for completion of the 1/O operation. 


1/O Packet: 

WORD Sl $2 $3 H2 
ee 
: 
a 
: 
2 


Write 

Write end of file on tape 

Contingency write tape 

Skip write tape 

Gather write 

Acquire mass storage 

Absolute write 

Read 

Read backward 

Read and release 

Release 

Block read drum 

Read and lock 

Unlock 

Absolute read (privileged 
user and system only) 

Track search all words 

Track search first word 

Position search all words 

Position search first word 

Search drum 

Block search drum 

Search read drum 

Block search read drum 

Rewind 

Rewind with interlock 
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Set mode 
Scatter read 


Scatter read backward 
Absolute read 

Move forward 

Move backward 
Forward space file 
Backspace file 


For I/O functions involving no transfer of data, such as write end of file, only 
packet words O through 3 are required. For tape I/O, only words 0 through 4 are 
required. For drum 1/O not involving a search function or absolute drum ad- 
dressing, only words 0 through 5 are required. 


All 1/O status codes are defined under type 1 in Section 4. Several !/O packet 
fields are also described. 


Word 4 of the I/O packet is the ISI access control word shown in Section 5. G is 
usually zero, specifying incrementation to the next word of the buffer following 
each one-word transfer. 


The buffer-addr is for an area in the user program that is at least as large as the 
value in word-count. In the case of scatter read and gather write functions, this 
buffer contains a string of access control words; otherwise, it is for the data being 
transferred. 


The drum addresses in words 5 and 7 are relative to word 0 or sector 0 of the user- 


assigned file name in the packet. If the file is in FASTRAND mass storage format, 
the address is in sectors; otherwise, it Is in words. 


The !/O packet for a tape (ISOT) or drum (I$OD) function can be generated by 
using one of the following proc calls (undesired parameters may be omitted): 


ISOT = ‘filename’ function word-count,buffer-addr,G 
I$OD = ‘filename’ function word-count,buffer-addr,G drum-addr,search-sentinel 


lOARBS L,U AO, pktaddr 
(21g) ER 10ARBS$ 


Initiates an arbitrary device 1/O operation with control returned, in line, as soon 
as the request is either listed or the operations have been initiated. An interrupt 
activity is initiated when the request is completed. 


Packet — see l|OAX1IS$. 


1OAXI$ L,U AO,pktaddr 
(20g) ER  10AXI$ 


Initiates an arbitrary device !/O operation with the referenced activity simulating 
an exit function, and controls the return to the program at the appropriate interrupt 
activity specified in the request packet. 


Arbitrary device |/O packet: 


WORD S1 $2 $3 H2 

0 

‘ internal filename 

2 used by executive int-act-id interrupt-activity-addr 
system p y 

3 el monitor-interrupt-activity-addr 

4 time-out | time-ind function-string 

5 initial-access-word-1 
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The activity performing the IOAXI$ request does not actually exit, but saving and 
restoring registers is eliminated (except for register AO), and the register set is 
reduced to the minor set only. The continuation of the IOAXI$ activity at the 
interrupt point is with the same activity-id; hence, the value in the int-act-id field is 
ignored for the |OAX$ request. 


101$ L,U A0,pktaddr 
(23) ER 101$ 


These two instructions can be generated by the proc: 
I$O1 pktaddr 
Identical to ER 10$ except that when the I/O operation is completed, a specified 
interrupt activity is initiated at the highest possible priority allowed for this pro- 
gram class. 
1/O packet — identical to 10$, except that word 2 contains: 
WORD Ti $3 H2 


The interrupt-activity-identity (1-35) may be used if synchronization via AWAITS 
is intended with some other activity. 


Upon entering the interrupt activity, all registers are destroyed except AO, which 
contains the !/O packet address. The interrupt activity is limited to using the minor 
set of registers (X8—X11, AO—A5, R1—R3). 


The I$OT and I$OD procs for generating the |/O packet are the same as for !0$, 
except that two additional subfields are appended to the first parameter field: 


‘filename’ function,interrupt-activity-address,int-act-id 


1Oows L,U AO, pktaddr 
(3g) ER lows 


These two instructions can be generated by the proc: 


ISOW _ ppktaddr 


Identical to ER 10$ except that control is not returned until completion of the 1/O 
operation. 


1/O packet — identical to 1O$. 


1owls L,U AO, pktaddr 
(24g) ER  10WI$ 


These two instructions can be generated by the proc: 
ISOWI!  pktaddr 
This request combines the features of 1OI$ and |OW$, Control is not returned 
until completion of the !/O operation. Upon completion, a specified interrupt 
activity is initiated at high priority. 


1/O packet — identical to |O1$. 


1OXI$ LU AO,pktaddr 
(25g) ER —-1OXI$ 


These two instructions can be generated by the proc: 
ISOX1 = pktaddr 

Identical to 1OIS, except that the activity making the request exits. 

1/O packet — identical to IOI$. 


LABELS L,U AO,pktaddr 
(31g) ER LABELS 


Enable the user to read or write any label block in the first label group on the 
volume except the VOL1 block. 
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ASCII- 


Fieldata jabel-buffer-addr 
translation 


internal filename 


S1_ If set to 0, indicates normal completion; if set to 40g, indicates abnormal 
completion (check S2 and S3). 


S2 Contains I/O status (if 0, all !/O has completed normally; if a nonzero value, 
see status for abnormal 1/O in Section 4). 


S3 If 1, indicates invalid label buffer address. 


If 2, indicates that a request was made to read a label following a request to 
write a label. 


If 4, indicates invalid filename. 

lf 6, indicates an attempt was made to write on a tape file that was not avail- 
able for writing or an attempt was made to write a label following a request to 
read a label. 

\f 10g, indicates an invalid request (not 1, 2, or 4), or a write EOF request 
following a read of a label, or a write EOF request before HDR1 has been 
written. 


If 12g, indicates a request on a labeled tape. 


H2 Contains the label buffer address originally supplied by the user. 


LCORES L,U AO, highest-addr-still-required-in-Jbank-or- 
(44) Dbank 
ER LCORE$ 
or 
L A0,(BDI, highest-addr-still-required-in- 
bank) 


ER LCORES$ 
Release unneeded main storage at high end of a bank. 
The whole bank can be released by specifying the first address of the bank. Before 
releasing the control bank, the @MAP listing for the program should be checked to 


ensure that there are no necessary collector produced tables in the control bank. 


When an entire segment is in the area of main storage that is released, it is marked 
as not loaded. 


LINKS L AO, (‘six-character-repname’) 
(171g) ER _—_LINK$ 


Transfers control to a specified re-entrant processor (REP). 


The specified re-entrant processor must be one of the standard system REPs, or 
must have been registered with the executive via an RLIST$ request. 


Control is transferred to the starting address of the re-entrant processor absolute 


element. 
LOADS L,U AO,segname or L A0,(0400000,segname) 
(111g) L,U A1,jumpaddr 


ER LOAD$ 
Loads a segment of a program. 


If bit 35 of AO is set, the loader skips the initial clearing of main storage. This 
causes a faster load, but also causes any reserved areas in the segment that do not 
initially contain instructions or data to be initially filled with indeterminate con- 
tents rather than words of all zeros. 


Although the main segment of every program is always automatically loaded at 
start of execution, and stays loaded throughout execution, it is possible to re- 
initialize a program by reloading the main segment, using the value 0400000, 
instead of segname. This causes all other program segments to be marked as un- 
loaded. 
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If jumpaddr is zero, control is returned following ER LOADS. 


If segname was defined at @MAP time as an RSEG, register A2 must also be 
initialized: ; 


L,U A2,rseg-startaddr or L = A2,(bank-name,rseg-startaddr) 


The equivalent of the above instructions can be generated by the following proc 
(undesired trailing subfields may be omitted): 


LSOAD segname,jumpaddr, value-of-AO-bit-35,rseg-startaddr,bank-name 


MCORES$ L,U AO, highest-expansion-addr-required-for 
(433) Ibank-or-Dbank 

ER MCORE$ 

or 

L AO, (BDI, highest-addr-required-for-bank) 


ER MCORES 
Obtains additional main storage at high end of | or D bank. 


This request cannot be performed while any activities of a program are in real-time 
status, unless it can be done without moving the program. 


ER MCORES$ may be used to create space in an initially void bank. 


If the requested address is something less than or equal to the current program size, 
the request is ignored and control is returned to the user program. 


MSCON$ L,U AO, pktaddr 
(125g) ER | MSCON$ 


Obtains either the entire Master File Directory or entries pertaining to a particular 
file; provides the means of altering indicators in the directory items. 


MSCONS$ packets vary according to the function to be performed. For functions 
and formats of packets, see UN/VAC 1100 Series Operating System Programmer 
Reference, UP-4144 (current version). 


When MSCONS returns contro! to the user, register AO contains the original packet 
address in H2, possible error status codes in bits 29-18 and an EXEC- indicator in 
bits 34—30. 


35 34 30 29 24 23 1817 0 
exec- 1/O- error- 

S| indi- error- Status- packet-addr 
cator } indicator code 


If bit 35 = O and bits 29-18 = 0, this signifies normal completion of the requested 
function. 


If bit 35 = 0 and bits 23—18 contain 01, the 01 is a special status code returned by 
the DREADS function signifying that the end of the user buffer has been en- 
countered and there are more directory items to be returned. 


If bit 35 = 1 and the error status code is 024, the value in bits 29-—24 is the I/O 
status code received by MSCONS. 


If bit 35 = 1 and the error status code is other than 024, the possible status codes 


are: 

020 — Wrong MSCONSG function code in user packet. 

021 — User packet not within program limits. 

022 — _ Referenced file is not assigned to this user. 

023 — _ User is referencing a temporary file. 

025 — User buffer not within program limits. 

026 — User is referencing a nonexistent start item (returned by the DREADS 
function). 

027 — User buffer area not large enough (returned by MSALLS$ functions). Or 
user packet specifies zero for number of backup tape reels (returned by 
the DBACK$ function). 

031 — _ The referenced disc unit has been marked down or reserved (returned by 


the DGETP$S function). 
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032 — The user packet specifies an illegal pack-id, or the requested pack-id 
cannot be found. 


033 — The output file initial reserve is too small to contain the current total of 
system directory items (returned by the DGET$ function). 


034 — The cumulative total of system directory items has dynamically expanded 
beyond the capacity of the output file (returned by the DGET$ func- 
tion). This situation differs from that described for status code 33g, in 
that, in this instance DGET$ has been in process and directory items 
have been placed on output to the file. 


035 — The user program has !/O outstanding, is employing ESI activity, has a 
count of activities totaling more than one, or is supplying a data buffer 
which lies in a common bank (returned by functions DGET$ and 


DGETP$). 

036 — The packet specifies a maximum cycle range value not in the range 
1—3219, or less than the current range value (returned by the DCYC$ 
function). 

037 — _ The user is neither privileged, nor has the subject file been assigned with 


correct read/write keys (returned by the DBIT$ function). 


NAME$ L,U AO, activity-name 
(1463) ER NAMES 


Attaches a name to the calling activity for purposes of later referencing this activity 
via an ACTS or DACTS request. 


The executive expands the 18-bit activity-name supplied in AO to a full word by 
inserting three additional characters in the upper portion of AO. This full word 
name, which the executive returns in AO, must be used with subsequent ACT$ 
requests. The user supplied name must be unique within a program. 


NRT$ ER NRTS 
(62) 


Returns a real-time activity to original program type. 


OPT$ ER OPTS 
(633) 


Obtains in AO, in master bit notation, the option letters from the @XQT or other 
control statement that caused this program's execution. 


Master bit notation means that bit O is set for a Z option, bit 1 is set for a Y option, 
..., and bit 25 is set for an A option. 


PCHCA$ L AO, (image-word-length, image addr) 
(165g) ER  PCHCA$ 


Specifies control functions for a user-specified punch alternate (PNCHAS) file. 
This request is similar to PCHCN$, except that the first two words of the image 
specified by ‘image addr’ contain the name of the alternate file to which the func- 
tions are to be applied. 


The ASCII equivalent of PCHCA$ is APCHCA$ (77g). 


PCHCNS$ L AO,(image-word-length, image-addr) 
(164,) ER —- PCHCNS$ 


Specifies control functions for the symbiont PUNCHS$ file. 


See image definition under PRTCN$. The functions that are applicable to PUNCH$ 
files are: 


S,text-requesting-special-forms. 
C,options. 


The options relating to the C function, which causes the output symbionts to react 
as the input symbionts would to a @COL control statement, are: 


B — Switch to column binary. 

E — Switch to 80-column code. 

R — Insert a logical break into punch output files which is used by the 
punch symbionts when skipping forward through a punch file. 

W,line width — Changes the maximum card length from 14 words to the value 
specified. 
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The following additional options are recognized by the 9300 symbiont and are 
ignored by other card punch symbionts: 


1100 — Switch to Fieldata punch code pattern 
9000  — Switch to EBCDIC punch code pattern 
ASC — Switch to ASCII punch code pattern 
PCT$ L A0,(word-count-from-1-to-1000g ,buffer- 
(64g) addr) 
ER PCTS 


Obtains a copy of requested portions of this program's program control table (PCT) 
in user-specified buffer. 


Optional calling sequence: 

L,U AO,buffer-addr 

L A1,(word-count,relative-starting-addr-within-PCT) 
ER PCT$ 


The first calling sequence assumes a relative starting address within PCT of 0. 


The PCT formats are lengthy, technically complex, and subject to occasional 
changes. Refer to the latest 1100 Series Systems Memorandum and other current 


documents. 
PFD$ L,U AO,pktaddr 
(1063) ER PFDS 


Sets the ‘deleted’ flag for a program file element. 


Packet — see words O through 7 of PFI$. 


PFI$ L,U AO, pktaddr 
(1043) ER PFI$ 
or 
L A1,next write location 
LN,U AO,pktaddr 
ER PFI$ 


Inserts new element table entry into a program file table of contents. If this 
element’s name, version, and type duplicate that of another nondeleted element in 
the file, marks that other element deleted. The second calling sequence combines 
the functions of PFI$ and PFUWL$. 


WORD T1 $3 H2 

t 

2 

3 element name 

4 version-link-sequence-nbr pointer-link-sequence-nbr 

5 elt-type type-link -sequence-nbr 

8 

9 (type dependent: see following two-word format diagrams) 

10 sector-location-of-text-within-file 

1 

Flag Bits: Type of Element: 

35 — Deleted 1g — Symbolic 

30 — Arithmetic fault non- 23 — Assembler procedure 
interrupt mode” 3g — COBOL procedure 

29 — Arithmetic fault 4g — FORTRAN procedure 
compatibility mode* 53 —  Relocatable 

28 — ASCII symbolic 6g — Absolute 

26 —  Third-word sensitive 7g — Omnibus 

25 — Quarter-word sensitive 

24 — Marked in error 

“NOTE: 


The combined settings of bits 29 and 30 are meaningful only with regard to 1110 
execution and are interpreted as follows: 


00 — Unknown arithmetic fault mode 
01 — Arithmetic fault non-interrupt mode 
10 — Arithmetic fault compatibility mode 
71 — Insensitive arithmetic fault mode 
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Time-and-date is identical to the word returned by ER TDATES$, except that H1 
and H2 are reversed. 


Symbolic and Procedure Elements: 


WORD 35 31 30 24 23 1817 1211 0 


cycle-limit latest-cycle 


es 
Processor: 
0g ~— unmarked 5g — @ALG 12g — @APL 
ig ~ @ELT 6g — @MAP 13g — @BASIC 
2g — @ASM 7g — @DOC 14g, — @LISP 
33 — @COB 10g — @SECURE 15g — @PLUS 
4g — @FOR Tig. @SSG 


Relocatable Elements: 


WORD H1 H2 
sector-location-of-Preamble-within-file 


sector-length-of-Preamble sector-length-of-text 


Absolute Elements: 


Level 23 collector 


WORD H1 H2 
8 program-|-bank-word-length program-D-bank-word-length 


first-D-bank-addr-in-program sector-length-of-text 


Post level 23 collector 


T1 
0400 + other flag bits 


or 


T2 T3 


PFI$ uses words 2 through 11 to build the standard 10-word element table entry. 
The five ERs that begin with PF are called the program file package (PFP). Their 
operations are similar to several routines in the SYS$*RLIB$ element BSP (basic 
service package). 


When the PFP returns control to the user, a status is returned in A2: 


Og — Normal status 
1g — No find (for operation on existing element) 
2g — 1/Oerror 
3g — Program file not defined 
5g — Program file overflow 
PFS$ L,U AO,pktaddr 
(105,) ER PFS$ 


Search program file table of contents for an element of the name (and version) and 
type indicated. Fill in the remainder of words 4 through 11 of the packet with 
complete element table information. 


Packet — identical to PFI$, except only name and type must be furnished. 


PFUWLS$ L,U AO,(‘filename ‘) or L,U  AO,pktaddr 
(1073) L A1,(sector-address) 
ER PFUWLS$ 


Update program file’s next available write location to the sector address given in 
Al. 


Packet — see words 0 and 1 shown for PFI$. 


The two-word literal created above, where the filename in quotes has 12 characters 
(left-justified and space filled), contains the same contents as the first two words of 
the packet shown for PFI$. 
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PFWLS$ L,U AO,(‘filename ‘) or L,U  AO,pktaddr 
(110g) ER  PFWLS 


Obtains in Ai the program file’s next available write location. This is the address 
of the first sector following the existing text in the file. 


See comments for PFUWLS. 


PNCHAS L,U AO,pktaddr 
(145,) ER PNCHAS 


These two instructions can be generated by the proc: 
PSNCHA pktaddr 


Transfers a Fieldata image to a user-specified punch alternate (PNCHAS$) file. 


Packet: 
WORD T1 $3 H2 


12-character-Fieldata-filename 


The ASCII equivalent of PNCHAS$ is APNCHAS (73g). 


PRINTS PF FORM =: 12,6,18 
(163) L AO0,(PF line-spacing, word-count,buffer- 
addr) 
ER PRINTS 


Assuming the same print FORM definition, these 
two instructions can be generated by the proc: 


PSRINT (PF line-spacing,word-count,buffer- 
addr) 


Transfers a Fieldata image to the symbiont PRINT$ file. !f an image is greater 
than 22 words, the printing of the PRINTS$ file is aborted. 


The line-spacing field is usually set to 1. Maximum value is 2047. If images to be 
printed are in ASCII, they may be 33 words long, and an ER APRINT$ (70g) is 
used instead of ER PRINTS. 


PRNTAS L,U AO,pktaddr 
(1445) ER PRNTAS 


These two instructions can be generated by the proc: 
P$RNTA pktaddr 


Transfer a Fieldata image to a user-specified print alternate (PRNTAS$) file. If an 
image is greater than. 22 words, the printing of the PRNTAS$ file is aborted. 


Packet: 
WORD T1 $3 H2 
1 
12-character-Fieldata-filename 
2 


The action here is similar to that for PRINT$. The ASCI! equivalent of PRNTA$ 
is APRNTAS (719). 


PRTCAS L AO, (image-word-length,image-addr) 
(1558) ER PRTCA$ 


Specify control functions for a user-specified print alternate (PRNTAS$) file. 


This request is similar to PRTCN$, except that the first two words of the image 
specified by ‘image addr’ contain the name of the alternate file which the functions 
are to be applied to. 


The ASCII equivalent of PRTCA$ is APRTCA$ (76g). 
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PRTCN$ L AO, (image-word-length,image-addr) 
(137g) ER PRTCNS 


Specifies control functions for the symbiont PRINTS file. 


Image is a string of Fieldata-coded functions, each of which begins with a function 
letter, has its parameters separated by commas, and ends with a period. Spaces 
before, between, or after the functions in the image string are ignored. 


The functions that are applicable to PRINTS files are: 


— allow error recovery. 

— inhibit error recovery. 

: —  fine-number-to-which-printer-should-be-spaced. 
option, starting-page-number, text-of-heading. 

; — number-of-print-lines, top-margin,bottom-margin. 
— insert a logical break into the print output file. 

S, —  text-requesting-special-forms. 

W, line width change print line width to value specified. 


mZir—p 
] 


The options relating to the H function for heading are: 


X — Suppress printing page number and date. 
N  — _ Do not print heading. 


The ASCII equivalent of PRTCN$ is APRTCN$ (74g). 


PSR$ L AO, (bits-as-defined-below) 
(157,) ER PSR$ 


Sets O or 1 into any of three processor state register (PSR) bit positions. Obtains 
former PSR word in register A1 (first word of main PSR for 1110). 


Six bits in AO have defined meanings: 


{f bit O = 1, set PSR quarter-word mode to value of bit 17. 

If bit 2 = 1, set PSR double-precision underflow to value of bit 32. 

If bit 3 = 1, set PSR floating-point compatibility to value of bit 35. 
PUNCH$ L AO,(word count,buffer-addr) 
(1303) ER PUNCHS 


These two instructions can be generated by the proc: 
P$UNCH _ word-count,buffer-addr 

Transfers a Fieldata image to the symbiont PUNCH$ file. 

The ASCII equivalent of PUNCH$ is APUNCH$S (72g). 


READ$ L AO, (end-of-file-jump-addr,buffer-addr) 
(153) ER READS 


These two instructions can be generated by the proc: 
RSEAD end-of-file-jump-addr,buffer-addr 
Obtains the next Fieldata card image from the input run stream. 
If the original input was in ASCII code, READS translates it into Fieldata. 
If the code is wanted in ASCII instead of Fieldata, ER AREAD$ (166g) should be 
used instead of ER READS, and a buffer of 20 words instead of 14 words must be 


provided if the run stream is from a card reader. AREAD$ does translation to 
ASCII, if necessary. 


lf READ$ encounters an end-of-file (EOF) image instead of a normal data image, 
control is transferred to the specified end-of-file-jump-addr, with S6 of AO con- 
taining any sentinel character which appeared in column 6 of the @EOF statement. 


Upon normal return from READ$, H2 of AO contains a count of the number of 
words transferred, which excludes trailing words of all spaces. Other bits may be 
set in AO as follows: 


Bit 35 — Next control statement in the run stream cannot be passed to the 
user. Do not attempt additional READ$ requests. (Set only on 
return to EOF address.) 

34 — Currently reading from an @ADDed file or element. 
33 — Eoption on @ADD. (Set only on return to EOF address.) 
31 — Image is in the internal format (INFOR) of a control statement. 


RS SEE ISI IES LE I SF DL IS I I IT I A PO I I TP Sa AE TELE 
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30 — Used when bit 31 is set, to indicate that there are more INFOR 
words following those which have thus far been read for this control 
statement. 

29-18 — If nonzero, this is the CLIST$ index value, after encountering a 


CLIST$-specified control statement. (See ER CLIST$.) 


READAS L,U AO,pktaddr 
(423) ER READAS$ 


These two instructions can be generated by the proc: 
RSEADA _ pktaddr 


Obtains a Fieldata card image from a user-specified read alternate (READAS) file. 


Packet: 
WORD H1 H2 
0 end-of-file-return-addr buffer-addr 
1 . 
12-character-Fieldata-filename 
2 


The action is similar to that for READS. The ASCII equivalent of ER READAS is 
ER AREADAS (167g). 


The file named in this packet must be previously assigned, and in standard data file 
(SDF) format. 


RLINKS$ L AO, (‘six-character-repname’) 
(172g) ER RLINKS 


This request is the same as ER LINKS except that when it is used from within one 
re-entrant processor (REP) to chain out to another REP, the return point saved is 
not back to the calling REP, but to the return point that the calling REP itself 
would have used. 


RLISTS$ L AO, (entry-count-from-1-to-20, 
(1753) pktaddr) 
ER RLIST$ 


Registers a list of nonstandard re-entrant processors (REPs) with the executive. 


The packet is a single two-word file name, identifying where the REPs in the list 
reside, plus as many one-word Fieldata repname entries as are specified in the entry 
count. 


Each RLIST$ request causes previous RLIST$ entries for the calling run to be 
destroyed. An RLIST$ request with an entry count of zero deletes all entries. 


RT$ L,U mo-cwitchingphavity Yeveltomie10: 
(61) 35 
or 
LN,U AO,switching-priority-level-from-2-to 
35 
ER RT$ 


Upgrades program status to real time, or changes the switching priority of an 
activity that is already real! time. 


If contents of AO are negative, program will not be repositioned. 


SETBP$ L,U A1,BDI 
(156g) L AO, (breakpoint parameter) 
ER SETBPS$ 


Sets the UNIVAC 1110 programmable breakpoint register. 


The equivalent calling sequence may be generated via the SS$ETBP procedure using 
the following call: 


SSETBP _ breakpoint-addr control address-mask BDI 


en a Nt Pe PI 8 EE I TO TE SE EEG ET LES 
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The format of the breakpoint parameter is: 


35 3433 3029 24 23 0 


Jo}ofcontroiadar-mask] _breakpoint-addr | 


breakpoint-addr The relative address to be compared to either an instruction or 
storage operand address. Only one comparison can be made at 
a time. 


addr-mask Control bits which when set, force equality comparison for 
corresponding bits 5—O of the relative breakpoint address. Bit 
24 controls bit 0, bit 25 controls bit 1, etc. Any combination 
of bits can be set. This allows breakpointing on a block of 077 


addresses. 

control Bit 30 specifies initiation of a breakpoint interrupt during a 
store instruction. A ‘W’ is used to specify this bit if SSETBP is 
used. 


Bit 31 specifies initiation of a breakpoint interrupt during a 
read from storage. An ‘R’ is used to specify this bit if SSETBP 
is used. Both bits 30 and 31 (‘W’, ‘R’) can be specified simul- 
taneously. 


Bit 32 specifies initiation of a breakpoint interrupt for an in- 
struction address comparison. This bit must not be set if either 
bit 30 (‘W’) or bit 31 (‘R’) is set. A ‘P’ is used to specify this 
bit if SSETBP is used. 


Bit 33 specifies that a BDI is supplied in A1. If a BDI is supplied 
on the SSETBP call, this bit is automatically set. 


Bits 34 and 35 are not used, but must be zero. 


The BDI supplied in Ai is accepted only when bit 33 is set in the breakpoint 
parameter and permits setting of a breakpoint to a bank not currently in the pro- 
gram’s addressable area. If a BDI is not specified (bit 33 not set), on return, A1 
will contain either the previous BDI if a SETBP$ has previously been initiated and 
was currently active or the BDI reflecting the breakpoint address specified in the 
breakpoint parameter. If the relative address specified overlaps more than one 
bank, the BDI is determined from the active PSR. 


To clear the breakpoint setting, AO is set to zero on the ER SETBP$S request. 
If bits 30—32 are zero on the ER call, bit 32 (P-bit) is automatically set. 


SETCS$ L,U AO,any-number-from-0-to-77773 
(65,) ER —- SETC$ 


Sets the contents of the lower third of AO into T3 of the run’s condition word. 


The number in AO can represent a program status which can be retrieved by later 
programs in the run using CONDS, or subsequently tested from the control stream 


using @TEST. 
SNAPS Ss AO,pktaddr+2 
(1263) L,U AO, pktaddr 


ER SNAP$ 


Obtains a snapshop dump of selected control registers and areas of main storage. 


WORD 35 $3332 1817 0 
0 snapshot-identifier(6 characters Fieldata) 
2 former-A0-contents 


The XAR field is the three high order bits of word 1, and specifies which sets of 
control registers to dump: 


Og — None 4g — Only X 

1g -— Only R 53 — XandR 

2g -— OnlyA 6g — XandA 

33 — RandA 7g — All registers 


The former-AQ-contents are dumped as the value of AO, and restored automatically 
into AO following the SNAP$. 


TEE BERET ST PPT I A PE EE I A TE I II TT SID 
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The following proc call generates in sequence, the above three instructions, a J 
$+4 instruction, and the above three-word packet, which is everything needed to 
accomplish a SNAP$ request: 


LSSNAP ‘snapshot-identifier’,X AR,word-count,start-addr 


TDATES ER TDATES 
(549) 


Obtains in AO the current date and time in binary code. 
AO Format: 
$1 $2 $3 H2 


AO mm dd VV time-in-seconds-from-midnight 


mm is month, from 1 to 12 
dd is day, from 1 to 31 
yy is year, modulo 1964 
TFORKS$ L AO, (parameter-word) 
(14,) L,U A1,wait-time-from-2-to-30000-in- 
milliseconds 


ER TFORKS 


Registers a concurrent program activity, following the wait time specified in 
register Al. 


This is identical to ER FORKS, except for the wait time specification. 30,000 
milliseconds is 30 seconds. 


There is no delay in the calling activity. 
For a real-time activity, the wait-time specified may exceed 30 seconds. 


TIMES ER TIMES 
(23g) 


Obtains in AO the current time in milliseconds past midnight. 


TINTLS L,U AO,(‘filename ‘) 
(136g) ER TINTL$ 


Reinitializes a tape file containing one or more reels back to load point of the first 
reel, to allow an additional pass of the file. 


The above two-word Fieldata literal is 12 characters, left-justified and space-filled. 


TREADS L,U — AO,pktaddr 
(102g) ER TREADS 


This is the equivalent of a PRINTS request followed by a READ$ request. 


Packet: 
$3 


T1 H2 
aca 2 image- ; . 
end-of-file-return-addr input-buffer-addr 


Word 1 of this packet, and register AO after control is returned, are handled in the 
same manner as on ER READS. 


WORD 


0 


If the characters being transmitted are in ASCII rather than Fieldata, ER ATREADS 
(170g) is used instead of ER TREADS. 


TSQCL$ ER TSQCL$ 
(113g) 


Deregisters Test and Set queuing. 
Returns Test and Set conflict processing to normal mode. If TSQ mode is cleared 


with activities still queued, they will remain queued until a CSTS, C$TSA, or 
C$TSOQ is done. 
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TSORG$ ER _TSQRG$ 
(121g) 


Registers automatic queuing of Test and Set conflicts. 


Activities which encounter Test and Set conflicts on T$CELL cells will be de- 
activated and queued by the executive. 


TSWAPS L AO, (function,pktaddr) 
(135g) ER _ TSWAP$ 


Close the current reel for a tape file and request loading of the next reel of the file. 


Packet: 


filename 


for-use-on-a-function-1-or-2-request 


Inclusion of a function in H1 of register AO indicates the following: 


WORD 


Function Description 
0 Swaps to the next reel of the file. 
1 Swaps to the next reel of the file and places the reel num- 


ber in word 2 (3rd word) of the request package. 


2 A request is made to mount reel specified in word 2 of the 
request packet. If this reel is not currently recorded as 
part of the file, it is added as the tast reel. 

TWAITS L,U A1,wait-time-from-2-to-30000-in- 


(60g) milliseconds 
ER TWAITS 


Delays execution for a specified timed wait period. 

Note that A1 is used, not AO. 30,000 milliseconds is 30 seconds. 

For a real-time activity, the wait time specified may exceed 30 seconds. 
T$SCELL tscell TSCELL 


This is not an ER, but rather a proc for generating special test-and-set cells for use 
with Test and Set queuing. tscell is any label by which the cell is referenced. 


UNLCK$S ER UNLCK$ 
(674) 


This ER enables an I/O interrupt activity to reduce its switching priority to the 
priority of the activity which initiated the I/O request. 


UNLNK$ ER _- UNLNK$ 
(174,) 


Unlinks a re-entrant processor (REP) by returning control directly back to the main 
user program, even though there may be other REPs in the calling chain between 
this REP and the main program. 


WAITS TP ppktaddr+3 
(63) ER _— WAITS 


Delays execution until the 1/O operation controlled by a specified 1/O packet has 
been completed. 


1/O packet: (See 10$.) 


WANY$ ER WANYS 
(79) 


Delays execution until any current |/O operation is completed. 


An error results if no !/O operations are still in process or if none have completed 
since the last waiting type ER request. 


An LCORES request will have caused all outstanding |/O to be completed. 


a eet ed 
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3S. LIBRARY SUBROUTINE 
PACKAGES 


These packages consist of sets of one or more relocatable subroutine elements which, 
if referenced by any of the subroutine entry point names given below, become a part of 
the user’s program when it is @MAPped. These elements reside in the system relocatable 
library file, SYS$*RLIBS. 


The reentrant subroutines may be called on simultaneously by different activities of 
the same program. The term re-entrant is defined as: that an activity executing the sub- 
routine may be interrupted many times, and then each time re-enter the subroutine for 
resumption of execution following the point of interruption, without having any of its 
necessary data destroyed by other activities that were executing the same instructions 
during the original activity’s interruption. Since each activity has its separate set of 
control registers, and also its separate calling packet and buffers, all changeable data in 
a re-entrant subroutine must be kept in registers or in one of these user-supplied loca- 
tions. 


BLOCK BUFFERING PACKAGE (BBP) 


The block buffering package (BBP) is a set of re-entrant subroutines, which may be used 
to simplify the reading in or writing out of blocks of data in main storage, either to or 
from tape or FASTRAND-format mass storage files. While one block of data is being 
written out, for example, another area of buffer is automatically made available to the 
user for setting up a further write. Blocks of data ina FASTRAND-format file may be 
referenced randomly (nonsequentially) by their relative block number, if desired, with- 
out regard to actual sector addresses or whether a given block happens to fill only 
partial sectors. 


When block buffering is initialized for a particular file (see: BOPENS$ subroutine), the 
file is defined as being in input, output, or in/out mode. Restrictions on these modes 


are: 
Input — no writing operations are permitted 
Output — no reading operations are permitted 
In/out — only for FASTRAND-format mass storage files (both input and 


output operations are permitted) 
For sequential read and writes, block sizes may be either fixed or variable in length. 


Random (nonsequential) reads and writes are restricted to FASTRAND-format mass 
storage files, use a fixed length block size, and require that a block number be specified. 


BBP precedes each variable-length block on FASTRAND mass storage with a single 
word which specifies the block’s word size. 


On return from each BBP open or read operation for an input or in/out mode file, 
register AQ contains: 


H1 H2 


word-count-of-block-read addr-of-block-read 


On return from each BBP open, write, mark, or close reel operation for an output or in/ 
out mode file, register AO contains: 


H1 H2 
word-count-of-next- addr-of-nex t-block-to-write 
block-to-write 


The word-count in H1 is either a fixed-length block size or, in the case of a variable- 
length block file, the maximum area available in the buffer. When an in/out mode file 
is opened, the block pointed to by AQ is both the first block of the file, that has already 
been read in, and the block that will be written out on the next write request. This 
allows the file’s label block to be easily updated. 


When a cataloged file is closed by BBP, its block size and (if FASTRAND mass storage) 
end-of-file sector address are saved in the master file directory. The complement of the 
block size is used if the block size is variable. This information is then automatically 
retrieved, if not specified, on a subsequent opening of the file. 


BBP works with a 25-word file control table (FCT) having the following format, where 
words 0 through 5 are an 1/O packet of the format shown for ER 10$ in Section 2. 


a ee 
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look-ahead 


({t/O-error-exit] 


{sentinel-value]} 
addr-of-buffer-packet activity ’s-reentry-addr 


cumulative-block-count 


addr-of-last-of-queued-buffers addr-of-first-of-queued-buffers 


current-data-location-in-buffer save-of-BBP-routine-return-addr 


frame- queue- 
count count 


sector-count 


tape- IN/OUT- abnormal- pane 
aoe joi Hock location 


highest-F AST RAND-mass-storage-addr 
FASTRAND-mass-storage-end-of-file-addr 


{test-and- | [sentinel- 
set] pos] 


Most of the fields are initially zero-filled prior to a call on BOPENS$. The fields shown in 
italics do not require further attention by the user, and are used for internal control 
purposes by BBP. 
Fields which must be specially initialized are: 
Filename in words 0 and 1 (see !1/O packet under ER 10$). 
Open-flag which is set to 1 to show that FCT is unopened. 
Fixed-block which is set to 1 if block length is fixed; otherwise zero. 
Addr-of-buffer-control-packet (see BPOOL$). 


Other fields which may be set are: 


Look-ahead — normally should be set to (and may not exceed) the number of buffers 
in the buffer pool less 1. This is the number of blocks to read ahead for input files. 


Max-block-word-count — this is set to the maximum possible value (buffer size minus 
three words) if unspecified. 


1/O-error-exit — address to which control should be transferred (instead of taking direct 
ERR exit) if an !/O error is encountered. The 1/O error code (see type 1 in Section 4) 
is returned in H1 of A1, and the user's re-entry address to resume processing is returned 
in H2 of Al. 


BBP-call-error-exit — address to which control should be transferred (instead of taking 
direct ERR exit) if one of the following BBP call error conditions is encountered. The 
error code is returned in H1 of A1, and a re-entry address in H2 of Al. 

BBP Call Error Codes: 

1g — Missing buffer pool link. 


28 — Request made to close a previously closed file. 


Se a RT TS PI FA I BITRE IE ER INIT 
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3 — Request made to open a previously opened file. 

4g, — Request to read or write a closed file. 

5g — Request to write a block greater than maximum block size, or rewrite a block 
in in/out mode and size requested to write is greater than size read. 

6g  — Specified FASTRAND mass storage variable block size exceeds maximum 
block size or an attempt was made to read variable blocks from a fixed-block 
file. 

7g — A random request was made on a file that was not assigned to FASTRAND 
mass storage. 

10g — Random request made and block size is not fixed. 

11g — Insufficient buffers in pool to satisfy look ahead for input or output. 

12g — Invalid block number for random read request. 

13g — Read request for a block greater than block size read. 

14g  — File not assigned to FASTRAND mass storage for in/out mode. 

15g — Random write request for input file. 

16g — Random read request for output file. 

17g, — Read request with move-length parameter specified but no move-address 
specified. 

20, ~— Read request for output file. 

21g — Buffer size less than specified block size. 

23g — Location of link or buffer area outside user’s assigned area. 


24, — Block size not fixed for reverse mode for FASTRAND mass storage file. 

25g ~— Nol/O facilities assigned or improper equipment type. 

26, — Write request for input file. 

27, — Mark request for input file. 

64, — Invalid mode parameter for open request. 

Abnormal-condition-exit — address to which control should be transferred when any of 
the following conditions are encountered. The condition code is returned in H1 of A1, 


and a re-entry address in H2 of Al. 


Condition Codes: 


1g — End-of-file or load point encountered for input tape file. 

2g — End-of-tape encountered for output file. 

6g  — Sentinel block encountered. 

10g — Block of an in/out mode file that was previously read exclusively has been 


timed out by the system. 


Sentinel-value, Sentinel-position, and Mask-for-block-sentinel-check — a sentinel value 
not exceeding 36 bits, which is tested against the relative word in each block specified 
by sentinel position, ignoring those bit positions not set in mask for block sentinel 
check, to identify a ‘sentinel block”’. 


8-Word-register-save-location — an address in the user program where registers Al — 
A5 and R1 — R3 can be saved by BBP. If not specified, these registers are saved by 
BBP in its own area, but BBP can then not be called simultaneously by more than one 
activity and have reliable register contents returned. 


The FCT may be generated with al! necessary initial information by the following proc 
call, where * indicates fixed block size: 


FILE ‘filename’,/BBP’ ‘SIZE’,[*] [max-block-word-count] ; 
‘POOL’ addr-of-buffer-packet[,look-ahead] ; 
[‘ERROR’ BBP-call-error-exit,!/O-error-exit,abnormal-condition-exit] ; 
[‘SENT’ sentinel-value,sentinel-pos,mask-for-block-sentinel-check] ; 
[‘LABEL’ nbr-of-words,addr] ; 
[‘FREEWD’ nbr-of-words,addr] ; 
[‘REG’,8-word-register-save-location] 


rye  S S 
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BBP consists of ten basic subroutines (including BJOINS and BPOOLS, which may also 
be used apart from BBP), each of which is entered through the calling sequence: 


L,U AO,pktaddr 
LMJ X11,subroutine-name 


Most of these calling sequence instructions may be generated by proc calls. When this 
is done, the associated packets are also generated; the packets are put under a different 
location counter number (30) than the one currently in control. The subroutine names, 
packets, and descriptions are: 


BCLOF$ 


Close out a file control table (FCT) for an input, an output, or an in/out file, and 
release the pool of buffers which was held for this file control table. 


BCLOSE ‘FILE’ FCT-addr[,’N’] 


To close several file control tables, a string of several fields may be included in this proc 
call, each naming a different FCT address, with or without option. 


When the file is to be freed after being closed, the following proc cal! generates a test 
(TZ,S1 FCT-addr+6) and a jump (J $+3) instruction (prevents BCLOF$ from being 
called if the file is already closed); the two-instruction BCLOF$ calling sequence; the 
necessary instructions to dynamically @FREE the file; the BCLOF$ packet; and the 
@FREE image that is used by CSF$. This is everything needed to close and free a tape 
file: 


BREL FCT-addr 


BCLOR$ 


Close out the current reel, and initialize the following reel, of an input, an output, or an 
in/out file. 


This has the same packet as shown for BCLOF$. The proc calt is also the same as that 
shown for BCLOFS, except that ‘REEL’ replaces ‘FILE’: 


BCLOSE ‘REEL’ FCT-addr,option 


BJOINS 


Add additional words to the buffer area that was originally set up by the BPOOL$ sub- 
routine (or through the BSGPUL proc call, which is described under BPOOLS$). 


WORD H1 H2 
0 BPOOLS-packet-or- 
BSGPUL-call-addr 
1 word-length-of-additional-area addr-of-additional-area 
BMARK$ 


Write a hardware end-of-file mark on an output mode tape file. 
BMARK FCT-addr 


Several FCT address fields may be included in this proc call. 


BOPENS$ 


Initialize the file control table for subsequent block buffering operations on an input, 
output, or in/out mode file. 


BOPEN ‘file-mode-mnemonic’ FCT-addr,option 


To open several files, several FCT address fields may be named in this proc call, with or 
without option. 


BPOOL$ 
Set up a buffer pool for use by block buffering. 


The size of each buffer used by the block buffering subroutines must be three words 
larger than the maximum size block in the file(s) for which this buffer pool is used. 
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Instead of using the BPOOL$ subroutine at execution time to organize the buffer pool, 
the buffer pool may be set up at assembly time by using the following proc call at the 
starting location of the area which is available for buffers: 


BSGPUL number-of-buffers, size-of-each-buffer 


BREAD$ 
Read sequentially the next block from an input or in/out mode file. 


BREAD FCT-addr [move-to-area-word-count,move-to-area-addr] 


BRREAD$ 


Read (randomly) the fixed-length block, whose number is specified, from an input or 
in/out mode FASTRAND-format file. 


BRREAD FCT-addr block-number [move-to-area-word-count,move-to-area-addr] 


If exclusive use is wanted, use BXREAD instead of BRREAD. 


BRWRT$ 


Writes (randomly) a fixed-length block, into the specified block number position of an 
output or in/out mode FASTRAND-format file. 


BRWRIT FCT-addr block-number [move-from-area-word-count,move-from-area- 
addr] 


BWRIT$ 
Write sequentially a block into an output or in/out mode file. 


BWRIT FCT-addr [move-from-area-word-count,move-from-area-addr] 


DYNAMIC DUMPS 


Following a program's termination, all information saved by the Dynamic Dump 
routines is automatically printed out. 


Since the primary purpose of these subroutines is to write data into the file DIAGS, it 
would be impractical for them to be re-entrant. Therefore, not more than one activity 
of a program should currently reference these subroutines. 


There is a word in the data area of the Dynamic Dump routines called XSTAT$ which 
is initially set nonzero. If it should become desirable for all Dynamic Dump routines to 
return control immediately, without producing any dumps, XSTAT$ may be cleared to 
zero. This effectively turns off the Dynamic Dump routines. 


SZ XSTATS$ This instruction is generated by the proc call: 
X$OFF 


To return XSTAT$ to its original nonzero status, the following three instructions 
(which do not depend upon any specific register contents) may be used: 


S AO,XSTAT$ These three instructions (or their equivalent, in 
TNZ XSTATS$ some systems) are generated by the proc call: 
SN,H2 AO,XSTATS X$ON 


The parameter ‘format’ specifies a single letter, enclosed in quotes, which references 
either a standard or a user-defined editing format. If omitted, an octal dump is pro- 
duced. 


EEE LN EH IS I EET BS PS PE TER TNE OI ET EE 
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Number of Number of Number of 
Format Items Per Print Positions Decimal 
Parameter Definition Line Per Item Places 


Alphanumeric 


Double precision 
floating point 


Floating decimal 


Fixed decimal 
Integer 
Octal 


Instruction 


Only the more commonly used dynamic dump routines are described here. Refer to 
the UNIVAC 1100 Series Operating System Programmer Reference, UP-4144 (current 
version), Section 11, for a more detailed description of all the routines. 


‘format’ Specifies a single letter, enclosed in quotes, 
which references one of the following standard 
editing formats: A, E, F, | or O. Standard 
formats D and §S and user-defined formats 
cannot be specified. If omitted, an octal dump 
is produced. 


The number of calls on X$CW is not limited, but only five separate areas may be 
dumped. 


XDRUM$ 


Dumps portions of FASTRAND-formatted mass storage by making temporary use of a 
previously defined buffer initialized by the X$BUFR procedure. Portions of mass 
storzge to be dumped are read into the buffer, then the contents of the buffer is 
written into the diagnostic file. 


SLJ XDRUM$ This linkage may be generated by the pro- 
+  word-count,location-addr cedure call: 
+ ‘format’,|/O-pktaddr 
X$DRUM — 1/O-pktaddr,location-addr,word- 
count,format 


1/O-pktaddr Specifies the address of the I/O packet con- 
taining the internal filename. 


location-word-addr Specifies the address of a word which con- 
tains the relative starting sector address or a 
word address of the file to be dumped. (In 
some cases, this address may be 1/O-pktaddr+5, 
which contains a sector address or a word ad- 
dress.) The manner in which the file was 
assigned determines whether the address 
specified is a word address or a sector address. 


Use of the X$DRUM procedure requires a main storage buffer into which the mass 
storage dump can be read. For FASTRAND-formatted files, it is recommended that 
the buffer be some multiple of 28, the length of a FASTRAND mass storage sector. 
While a portion of mass storage that is larger than the size of the buffer may be dumped, 
greater efficiency results by providing a buffer that is sufficiently large to hold all the 
mass storage to be dumped at one time. 


If a main storage buffer is not reserved and initialized for the X$DRUM procedure, no 
mass storage dump occurs. 


The same buffer area can be used for both X$DRUM and X$TAPE procedure calls. 
XBACK$ and XMARK$ 


These routines are used in conjunction to mark the points in program execution be- 
tween which dynamic dumps are saved and then deleted at the user’s discretion. The 
X$MARK and X$BACK procedures permit a user program under checkout to include 
dynamic dump procedures which the user may want to print only when a routine does 
not terminate normally. 


FORMAT 1: 
SLJ XMARK$ This instruction may be generated by the 
procedure call: 
X$MARK 
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FORMAT 2: 


SLJ XBACK$ This instruction may be generated by the 
procedure call: 


X$BACK 
The X$MARK and X$BACK procedures behave much as left and right parentheses sur- 
rounding portions of a program which are to be dumped only if termination occurs 


between them. 


X$MARK and X$BACK pairs may be nested to a depth of five. The total number of 
occurrences of X$MARK and X$BACK is unrestricted. 


XBUFR$ 


Internally defines an area of main storage for use as a buffer by the X$TAPE or 
X$DRUM procedures. 


SLJ XBUFR$ This linkage may be generated by the pro- 
+ word-count,starting-addr cedure call: 


X$BUFR  starting-addr,word-count 


starting-addr Specifies the starting main storage address of 
the buffer. 
word-count Specifies the number of locations in the buf- 


fer to be initialized. 
XCORES 


Produces a dump of the specified main storage area. 


SLJ XCORE$ This linkage may be generated by the pro- 
N$ FORM 4,14,18 cedure call: 
N$ index-reg,word-count, 
starting-addr X$CORE _ starting-addr,word-count, ‘for- 
+ ‘format’,O mat’,index-reg 
starting-addr Specifies the main storage starting location of 
the dump. If omitted, starting location of zero 
is assumed. 
word-count Specifies the number of locations to be dump- 


ed (37777g maximum). 


index-reg Specifies the index register used to modify the 
address specified by the starting-addr param- 
eter. This parameter, which may be omitted 
or left zero, can be set to values from 1 to 15 
to specify an index register from X1 through 
A3. The vatue in the index register is added to 
the starting-addr value to get the actual dump 
starting address. 


XCREG$ 


Dumps specified user control registers. (The A,X and R registers and the unassigned 
registers at addresses 34g and 35g.) 


SLJ XCREG$ This linkage may be generated by the pro- 
+ register-count,starting-reg cedure call: 
+ ‘format’,O 


, 


X$CREG - starting-reg,reg-count,’format 


starting-reg Specifies the address of the first control regis- 
ter to be dumped. 

reg-count Specifies the number of control registers to be 
dumped. 

XCW$ 


Produces a changed word dump of specific locations within main storage. On the first 
X$CW call referencing a given main storage area, a complete dump of that area is pro- 
duced. On subsequent X$CW calls to the same area, only those words which were 
changed since the last X$CW procedure call are dumped showing the previous contents 
and the current contents. 
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SLJ XCWS$ This linkage may be generated by the pro- 
+ word-length,starting-addr cedure call: 
+ ‘format’,O 


X$CW starting-addr,word-length,‘format’ 


starting-addr Specifies the main storage starting location of 
the dump. 
word-length Specifies the number of locations to be 


dumped (377773 maximum). 
XDUMP$ 


Produces a dump of the program environment, A,X, and R registers, and main storage. 
Identical to XCORE$ except that a field is provided for specifying A,X, and R regis- 


ters. 
SLJ XDUMP$ This linkage may be generated by the pro- 
N$ FORM 4,14,18 cedure call: 
N$ index-reg,word-count, 
starting-addr X$DUMP - starting-addr,word-count, ‘for- 
+ ‘format’ register-code mat’,’AXR‘,index-reg 
‘AXR’ Specifies, enclosed in quotes, one or more 
letters representing the A,X and R registers. 
The contents of these registers are printed in 
octal. 
register-code Register codes for XDUMP$ are: 
No registers 0g 
R only 2004019 
A only 2002023 
RandA 400603, 
X only 2001043 
X and R 400505, 
XandA 400306 g 
A,X, and R 6007078 


The printout resulting from XDUMP$ is preceded by the heading: **DUMP**. The 
following additional information is provided following the **DUMP** heading: 


element name, location counter, relative program address, and hardware fault 
indicators. 


XFRMT$ 


Specifies a nonstandard editing format for use by the diagnostic dump procedure calls 
as an alternative to the standard editing formats or redefines the standard editing for- 
mats. New format labels such as ‘U’, ‘V’, or ‘W’ may be specified, or existing standard 
format labels may be redefined. 


SLJ XFRMT$ This linkage may be generated by the pro- 
+ format-specification-word- cedure call: 
length, ‘format-label’ 

‘(format-specification)’ X$F RMT format-specification-word- 
length, ‘format-label’ ‘(format-specifica- 
tion)’ 

format-specification-word-length Specifies the number of words comprising the 


format specification. 


‘format-label’ Specifies a single letter enclosed in quotation 
marks referencing one of the standard editing 
formats: A,D,E,|,0, or S. This action is used 
to redefine the standard editing formats. To 
specify a user-defined editing format, any let- 
ter (enclosed in quotes) except A,D,E,|,0, or 
S may be used. 


‘(format-specification)’ Specifies a string of alphanumeric characters 
which represent an encoding of the format to 
be applied to the information printed. The 
string of alphanumeric characters may not 
contain intervening blanks. The first nonblank 
character of the string must be a left paren- 
thesis (preceded by a quotation mark); the 
last nonblank character must be a right paren- 
thesis (followed by a quotation mark). 


The format of the string of characters that 
comprises this parameter is specified exactly 
as in FORTRAN V FORMAT statements. For 
example, specifying ‘(10F8.3)’ indicates that 
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the dump information printed on one line 
consists of 10 words of fixed-point decimal 
data and that each word is eight characters 
long with the decimal point at the left of the 
third least significant character. 


Any standard or used-specified editing format may be redefined; the most recent defini- 
tion prevails. ‘ 


Multiple line formats are allowed. 


Except as indicated below, any format that can be given in a FORTRAN V FORMAT 
statement can be specified. See UN/VAC 1100 Series FORTRAN V Programmer 
Reference, UP-4060 (current version) or UN/IVAC Fundamentals of FORTRAN Pro- 
grammer Reference, UP-7536 (current version). 


The following FORTRAN V editing codes are not supported by PMD: G, J, and R. The 
editing routines of PMD support an S editing code which assumes that the words being 
dumped are 1100 Series instructions and are split up into component parts. Twenty 
spaces in the print line are required for one word. The A editing code assumes that the 
words being dumped are assumed to contain Fieldata characters. 


XMESG$ 
Permits the user to place any message he desires into the dynamic dump. 


SLJ XMESG$ This linkage may be generated by the pro- 
+ word-length-of-msg,‘A’ cedure call: 
‘diagnostic-msg’ 
X$MESG_ word-length-of-msg 
‘diagnostic-msg’ 


word-length-of-msg Specifies a number equal to the number of 
computer words in the message (one computer 
word holds six characters). 


‘diagnostic-msg’ Any string of alphanumeric characters en- 
closed in quotes and printed exactly as as- 
sembled. 

‘A’ Generated by the procedure call. It is of no 


significance to the user, but it must be coded © 
when the instruction form of the format is 
used. 


The X$MESG procedure produces a line on the output listing of up to 120 alphanumeric 
characters. The-printed line immediately follows the procedure reference. 


The X$MESG procedure is executed only when the conditional dump switch is on. 
XSIZE$ 
Changes the length of the area of the diagnostic file reserved for dynamic dumps. 


SLJ XSIZE$ This linkage may be generated by the pro- 
+ length cedure call: 


X$SIZE length 


length Specifies the length (in sectors) of the diag- 
nostic file to be reserved for dynamic dumps. 


Using this procedure, a user program can dynamically expand or contract the length of 
the dynamic dump portion of the diagnostic file. If this is not used, a system standard 
value is assumed for the length of this portion of the file. If this procedure is used, it 
should be used before executing dynamic dumps to ensure enough space for those 
dumps taken. 


XTAPE$ 


Dumps the block of magnetic tape data located just prior to the current tape position 
by making temporary use of a previously defined buffer initialized by the X$BUFR 
procedure. The magnetic tape is moved backward one block, the block is read, and the 
number of words specified in the X$BUFR procedure is dumped. 


SLJ XTAPE$ This linkage may be generated by the pro- 
+ word-count,buffer-addr cedure call: 
+ ‘format’,|/O-pktaddr 

X$TAPE 1/O-pktaddr, ‘format’ 


1/O-pktaddr Specifies the address of the 1/O request packet 
for the device handler. This parameter may be 
the address of a file control table (FCT) as is 
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used by block buffering and other routines, 
since the first six words of an FCT are an 1/O 
packet. 


Interblock gaps separate the blocks that are recorded on magnetic tape each time an 
1/O write of any size word count is done. These interblock gaps serve as block sepa- 
rators. The X$TAPE procedure causes a move backward to the preceding interrecord 
gap, then a read of everything which follows into the buffer initialized by an XSBUFR 
procedure until the next interrecord gap is encountered. When the buffer is filled, the 
remaining words are lost. 


The X$TAPE procedure is useful for dumping a block that was just read or written. No 
dump occurs if the magnetic tape is positioned at the load point (beginning-of-tape 
marker) or at the interrecord gap following an EOF mark. 


No magnetic tape dump occurs if a main storage buffer is not reserved and initialized 
for the X$TAPE procedure. 


The same buffer area can be used for both X$DRUM and X$TAPE procedure calls. 


The word count and buffer address are returned by the X$TAPE procedure to the first 
parameter word. 


PROGRAM TRACE ROUTINE (SNOOPY) 


SNOOPY is a program trace routine which is designed for use primarily with assembly- 
language programs. In batch mode, SNOOPY provides a straightforward account of 
every instruction executed and its effect. In the demand mode, SNOOPY acts as a 
powerful diagnostic routine affording user control over the trace operation. When used 
on level 27 and earlier Operating Systems, the tag BANK$ may appear as undefined; 
this will cause no harm. 


Two formats are available for calling SNOOPY: 


SLJ SNOOPY 
+ mode-bits,termination-addr mode-word 


and 

SLJ TONS 
When the first format is employed, tracing begins with the instruction following the 
mode-word. Tracing continues until the termination address (termination-addr) is 
reached or until another termination condition is encountered. 
When the second format is employed, tracing begins following the SLJ instruction and 
continues until a termination condition is encountered; quarter-word or third-word 
mode is determined by the mode set on entry. 
When operating in the batch mode, tracing may be terminated by: 


(1) Reaching the specified termination address (program execution continues). 


(2) Executing an SLJ TOFF$ instruction (program execution continues). If an SLJ 
TOFF$ instruction is executed outside of the trace routine, it has no effect. 


(3) Performing an ER EXIT$. This not only terminates SNOOPY but it also terminates 
the activity being traced. 


(4) Encountering a program contingency of types 1g, 2g, 7g, or 12g for which stan- 
dard system action has been specified. The activity being traced is terminated by 
EXITS. 


When operating in the demand mode, tracing may be terminated by the following 
methods in addition to those available for batch mode: 


(1) Using the TOFF$ command; program execution continues. 


(2) Using the EX!IT$ command. This not only terminates SNOOPY but it also ter- 
minates the activity being traced. 


All commands listed may be abbreviated to the first three characters; all commands 
except ALTPRT, TON$, RBK and STEP may further be abbreviated to the first 
character only. 
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Certain commands (TOFF$, EXIT$, CHANGE) clear SNOOPY’s command buffer be- 
fore reading further commands because of the potentially irreversible nature of the 
operation to be performed. If this is not desired, an asterisk may be affixed to the 
command, as TOFF$*, EXIT$*, CHANGE*. For example, to terminate a trace and 
continue an execution without typing in two lines, the sequence ‘TOFF$* GO” may 
be used. 


Convert relative program addresses to absolute addresses. The three 
parameters are: 


eltname,loc-counter,location. 


The ABSAD command may be used to determine the value assigned 
by the collector to a particular externally defined symbol. Only 
referenced symbols defined by non-RLIB$ routines may be looked up 
unless the collection was done using the “TYPE EXTDIAG” state- 
ment, in which case all symbols may be looked up. The command 
format is “ABSAD <symbol> *’' where the trailing asterisk indicates 
that an external symbol is meant. For example, “ABSAD SNOOPY*” 
will print the address of SNOOPY’s entry point ‘““SNOOPY”. 


ALTPRT | Send all trace printout to an alternate print file, while command 
solicitation, command responses (as by DUMP, for example) and all 
print requests by the program are sent to the terminal as usual. One 
parameter may be given, which is the name of the file to be used as 
an alternate print file. 


When the ALTPRT command is given and an alternate file is in use, 
the current alternate file will be @BRKPTed. This action may be 
suppressed by employing an asterisk (*) as the trailing delimiter for 
the parameter; e.g., either “ALTPRT <filename> *" or “ALTPRT *”. 
To obtain printout both at a terminal and in an alternate file, the 
ALTPRT filename should have a trailing exclamation point (!); e.g., 
“ALTPRT <filename> !"’. If an alternate file is already active, the 
command forms “ALTPRT !"’ and ‘““ALTPRT ?” may be used to set 
and clear echo mode, while leaving the same alternate file in use. Echo 
mode is always cleared when the trailing exclamation point is not 
used; therefore, to start a new alternate file without breakpointing the 
old file and with echo mode set, the commands “ALTPRT * ALTPRT 
<filename>!"' must be used. 


Automatically return to command mode when control reaches a 
specified point in the program. Only one breakpoint may exist at a 
time. The three parameters are: 


eltname,loc-counter,rel-addr 


CHANGE | Allows the user to change the contents of control registers or main 
storage. The single parameter gives the location to be changed. 


If the parameter is a register name, a number, or a number preceded 
by an H or Q, the new value is to be entered as a single octal number. 


If the parameter is a number preceded by the letter |, the new value 
to be entered consists of six numbers, each separated by a space, and 
representing the f, j, a, x, hi, and u fields of an instruction word. 


The CHANGE command allows the use of mnemonics and external 
symbols for !-format (instruction format) changes, as well as octal 
values. The first item given to the ‘‘NEW VAL- -” type-out may be an 
op-code mnemonic instead of an octal number for the F-field. Ab- 
breviated forms such as L, LN, ANM are not permitted, however; LX, 
LA, LR, LNA, ANMA and so on, must be used. For some instruc- 
tions, the op-code mnemonic specifies values for the J-field and per- 
haps the A-field as well. In such cases, the next value given to the 
change command will be an A-field or X-field. Mnemonics may also 
be used for J-designator values and for standard X-, A-, and R-register 
names. If a register name is used in the A-field of an instruction, its 
value will be adjusted appropriately. Truncation errors are not de- 
tected. Fields of an instruction are always expected to be entered in 
the order F, J, A, X, Hl, and U. Note that the H and | fields are com- 
bined. An external symbol may be used for any field except the F- 
field, subject to the same restrictions as for the ABSAD command. 
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Display the program status. Each parameter must be separated by a 
comma. If no parameter or an empty parameter (that is, two consecu- 
tive commas) is given, all registers and the carry and overflow 
designators are dumped. The parameters are: 


A,X, or R ~— Dumps the indicated group of registers. To dump 
the contents of a single register, use the register 
mnemonic or the octal address. 

T ~ Dumps the carry and overflow designators. 

The letter | preceding a number produces an instruction-format dump. 
The Jetter H preceding a number produces a Fieldata-character dump. 
The letter Q preceding a number produces an ASCI1!-character dump. 
B - Display names of active banks (in order main-l, main-D, 

utility-[, utility-D, with commas indicating place for 

unbased PSR portions). 

Last contingency, if any. 

Display current storage limits. 

Display names of active segments. 
Combinations such as HAO, 1A13, QR7 are acceptable and are 
interpreted correctly. Any dump specification which references an 
address may be given a trailing + sign followed by an octal number N. 
A dump is then taken of the N consecutive storage locations following 
the original address, in the same format as the first dump, resulting in 


a dump of N+1 locations. 


Terminates the traced activity by means of an EXIT$ request. Trace 
mode is terminated and the last instruction is printed. 


Return to trace mode from command mode. 


A jump history table is maintained by SNOOPY;; this table contains 
the addresses of the last 8 jump instructions which caused a transfer 
of control. The JHT command will cause this table to be printed, 
starting with the most recent jump-from address. The table is cleared 
on entry to SNOOPY, so fewer than 8 addresses may be printed early 
in a trace. 


Transfers control to a specified absolute address. The current absolute 
and relative P register values are displayed. If the new value is within 
the program storage limits, that value is set into the P register. The 
new value is printed in relative form and the next command is 
executed. 


The jump-to address specified for the JUMP command may be an 
external symbol as well as an octal value, subject to the restrictions 
on externally defined symbols noted for the ABSAD command. 


Adjust the length of the line printed by SNOOPY. If “LINE /”’ is 
entered, the line length set is the default value of 110g. Otherwise, 
the parameter given to LINE must be an octal number denoting the 
line length for the device in use. 


number Has the same effect as a SKIP n GO sequence (where n is the number). 
See SKIP command. The number is in octal. 


PRINT Allows modification of the amount of printing. The PRINT com- 
mand recognizes only one parameter at any one time. If an invalid 


parameter is specified, the F parameter is assumed. The parameters 
are: 


Produce a printout omitting extraneous spaces used for 
formatting. 


Produce an expanded printout (formatting spaces are 
included). The E mode is effective until a PRINT C is 
encountered. 


Produce a full printout consisting of each instruction, 
its location, and the contents of main storage and 
registers (in before/after form if the value changed). 
For certain Executive Requests, the contents of the 
associated packet is also dumped. This is the default 
mode. 
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Suppresses printout. This provides a means of skipping 
long sections of irrelevant code. 


Produce printout of the instructions but not referenced 
main storage or Executive Request packets. 1f SNOOPY 
is in the N mode, the P mode is set automatically upon 
the occurrence of an RBK contingency or encountering 
a BREAK specified break condition. 


Allows the user to simulate an RBK contingency for the executing 
program; the actual RBK contingency is intercepted by SNOOPY and 
directs a return to command mode. This command provides the 
means for tracing a contingency routine. If the user program does not 
expect the contingency, an appropriate message is displayed. 


Convert absolute program addresses to relative addresses. The only 
parameter is: location. 


Ambiguities are resolved in favor of elements residing in currently 
loaded segments in currently active banks. 


“RLIB L”’ will print the system type, system level identification, and 
site as well as the RLIBS level used at collection time. 


“RLIB E, <element-list> ’’ where <element-list> is a list of element 
names separated by commas specifies that the elements named are to 
be treated as if they were RLIBS$ elements for the purposes of RLIB$S 
trace suppression. The list specified completely replaces any preceding 
list. An empty list is specified by following the ‘’E’’ with punctuation 
other than a comma or question mark. ‘““RLIB E?” prints the current 
list. At present, the list may contain at most 16 names. 


Return to command mode after executing n number of instruction 
cycles. If n is omitted, any previously existing skip count is deleted 
and no skip interrupt occurs.- Otherwise, an octal number is used to 
set the interrupt point. If the count is exceeded during an indirect 
addressing or execute remote cascade, the command mode is re- 
entered when the instruction is completed. 


Execute one instruction in trace mode and return to command mode. 


Leave the trace mode and continue execution as if an SLU TOFFS 
command had been executed. Trace mode is terminated and the last 
instruction is printed. 


Restart a trace that was to be terminated and execute one instruction. 
To compute the number of instruction cycles performed, use the 
TOFF$ command followed by the TONS command. The TONS com- 
mand is not affected if the activity is about to terminate by means of 
an EXIT$ request; if it is desired to continue tracing from that point, 
a JUMP command must first establish a point from which execution 
will continue. 


A new command is available which will cause SNOOPY to enter com- 
mand mode from trace mode whenever one of a set of locations is 
referenced or altered, except for ER operations. Entering the com- 
mand “TRAP <loc-1> , Cioc—2>. . ." will place up to sixteen 
locations in the trap table. Commas must be used as separators. The 
locations may be octal numbers, register mnemonics, or external 
symbols. The use of external symbols is subject to the restrictions 
noted for the ABSAD command. Each list specified completely re- 
places the preceding list. The command “TRAP?” will print out the 
current list. 


EDITING PACKAGE FOR IMAGE COMPOSITION (EDITS) 


EDITS is a set of simplified re-entrant subroutines which may be used for composing 
strings of Fieldata characters in an area specified by the user. It is particularly useful 
in preparing images for ER CSF$, ER PRINTS, ER PUNCHS$, ER PRTCNS, and 
PCHCNS. 


EDITS works from the following packet, where words 6 through 9 are not needed 
unless there are floating-point (FP) numbers to be edited. 
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S1 
[test-and- 
set] 
char- word- EMSG$- 
index index char 


FPR 


digits- digits- negative- not- 
before after sign normalized 
final-column-position characteristic’s-power-of-ten 


save-area-for-intermediate-floating-point-results 


Most of these packet fields, shown in italics, do not require attention, and are used 
simply for internal contro! purposes by EDITS. 


@ When not using EDITS’s floating-point subroutines, the user needs to supply in- 
formation for only three fields, which are all located in word O of the packet: 


EMSG$-stop 


A special stop character (‘&' is frequently used) which, when one or more are 
imbedded in an EMSG$ input image, causes the EMSG$ routine to stop trans- 
ferring characters from the input image each time it encounters one of these 
characters. This can serve not only as the final EMSG$ input image stop, but can 
also cause intermediate stops to allow the user to insert new information (such as 
status codes or names, using various other EDIT$ routines) at any predetermined 
points within the EMSG$ image. 


image-length 


The size of the output image buffer (normally 22 words when composing lines of 
print for a 132-column line printer). 


image-addr 


The address of the output image buffer. When the image is fully formed, this buffer 
can be directly referenced on a call to CSF$, PRINTS, etc. 


@ Four additional fields are used only with floating point: 
FPS 


The scale, or number of digits to be placed before the decimal point, for scientific 
format floating-point editing. This is usually set to 1. 


FPR 


Set nonzero (which is the usual case) to specify floating-point rounding, which 
means that 5 is added to the eighth significant digit for single-precision numbers or 
to the eighteenth significant digit for double-precision numbers. 


DPC 


If nonzero, this is the character to use when editing double-precision floating-point 
numbers, to separate the mantissa and the characteristic. (This is for compatibility 
with existing formats, such as the ‘E’ used with FORTRAN.) 


SPC 
This is the same as DPC, except that it is for single-precision floating-point numbers. 


@ The following proc call generates a six-word EDITS packet, where ‘&’ is generated 
for the EMSG$-stop-character if the ‘MSG’ parameter is omitted: 


E$PKT image-length,image-addr [‘MSG’,/EMSG$-stop-character’] 


@ The following proc call generates a 10-word EDIT$ packet, where these assumed 
values are inserted in omitted parameters: ‘MSG’=’&’, ‘FPS‘=1, ‘FPR’=1, ‘DPC’=0, 
‘SPC’=0. 
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E$PKTF image-length,image-addr ['MSG’,/EMSG$-stop-character’] ; 
[‘FPS’,FPS-number] [‘FPR’,FPR-number] (‘DPC’,‘DPC-character‘] ; 
{‘SPC’,‘SPC-character’] 


On all of the proc calls shown below for EDIT$ subroutines, when any of the 
parameters are omitted, the corresponding calling sequence’s load AO or load A1 
instruction is not generated. 


@ EDITS has three subroutine calls for initiating or terminating editing mode: 
EDIT$ 


Initiate editing mode. The contents of registers X1, X2, and X3 are saved. The 
image is space-filled, and the column pointer is set to the start of the image. (Note 
that EDITS also uses, but does not save or restore, registers X11, AOQ—A3, and R1.) 


L,U AO,pktaddr These two instructions are generated by the proc call: 
LMJ X11, EDITS 
ESDIT pktaddr 


EDITX$ 


Terminate editing mode. The column pointer is saved in the packet. Registers X1, 
X2, and X3 are restored to their original contents. The address of the packet that 
Was active is returned in AO. 


LMJ X11,EDITX$ This instruction is generated by the proc call: 
ESDITX 
EDITRS$ 


Re-establish the editing mode to its status at the time of the previous call to 
EDIT X$. The column pointer saved by EDIT X$ is restored. 


L,U AO,pktaddr These two instructions are generated by the proc call: 
LMJ X11,EDITR$ 
ESDITR pktaddr 


® EDITS has 18 nonfloating-point subroutines for such purposes as converting num- 
bers into Fieldata, inserting strings of characters into the image, and manipulating 
the column pointer. Note that in all cases where one or more characters are 
inserted into the image, they are inserted beginning at the current column pointer 
location (which js initially set to column 0 by the initiate editing mode subroutine), 
and the column pointer is always advanced to the column following the last in- 
serted character. These subroutines are listed alphabetically: 


ECHARS 
Insert the character in S6 of AO into the image. 
L,U AO, ‘character’ These two instructions are generated by the proc call: 


LMJ X11,ECHAR$ 
ESCHAR ‘character’ 


or 
L AO,addr-of-character These two instructions are generated by the follow- 
LMJ X11,ECHARS ing proc call, where addr-of-character may contain 
any of the x, h, i, u, or j instruction word fields in 
the standard “u,*x,j form (see Section 6): 
E$CHAR addr-of-character 
ECOLS 


Advance or back up the column pointer to the column number in AQ. (Note that a 
previously inserted character or string can be backed up to, and then overwritten if 


desired.) 
L,U A0,column-number These two instructions are generated by the proc 
LMJ X11,ECOLS call: 
E$COL column-number 
ECOLNS 


Obtain the current column pointer number in AO. 
LMJ X11,ECOLN$ This instruction is generated by the proc call: 


ESCOLN 
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ECOPYS 


Insert into the image the number of characters specified in A1, taken from the 
location whose starting address is given in AO. All characters are transferred, 
including spaces. 


L,U A1,character-count These three instructions are generated by the 
L,U AO,addr-of-characters following proc call: 
LMJ X11,ECOPY$ 

ESCOPY character-count,addr-of-characters 


EDAY1$ 

Convert the date portion of a TDATE$ format word (see ER TDATE$ — Section 
2) in AO to an eight-character Fieldata string of the informal-U.S.-style date repre- 
sentation where, for example, ‘02/04/70’ would represent the 4th of February, 
1970. Insert this string into the image. 


L AO,addr-of-TDATE$-word These two instructions are generated by the 
LMJ X11,EDAY1$ proc call: 


ESDAY1. addr-of-TDATE$-word 


or, for today's date: 


ER TDATES These two instructions are generated by the 
LMJ X11,EDAY1$ proc call: 

ESDAT1 
EDAY2$ 


This is the same as EDAY1$, except that the date cited by the example would be 
converted to the unambigious nine-character Fieldata string, ‘04 FEB 70’. The 
corresponding proc calis for EDAY2$ are ESDAY2 and ESDAT2. 


EDAY3$ 


This is the same as EDAY1$, except that the date is converted to a variable length 
string, ranging from 11 to 18 Fieldata characters, defined briefly by the following 
three examples: ‘FEBRUARY 4, 1970’, ‘MAY 1, 1970’, ‘SEPTEMBER 18, 1970’. 
The corresponding proc calls for EDAY3$ are ESDAY3 and E$DAT3. 


EDECFS 


Convert the number in AO to Fieldata decimal digits, and set the result (right- 
justified and space-filled) into a fixed-length field of the number of characters 
specified in Al. If the number of Fieldata digits (including a leading ‘—’, if the 
number in AO is negative) exceeds the field size specified, they overflow the field. 
Insert this field into the image. 


L,U A1,character-count These three instructions are generated by the 
L AO,addr-of-number proc call: 
LMJ X11,EDECF$ 


ESDECF character-count,addr-of-number 


EDECV$ 


This is the same as EDECFS, except that the field size is variable, and only as large 
as is necessary to hold the converted Fieldata decimal number (including a leading 
‘~—', if the number in AO is negative). 


L AO,addr-of-number These two instructions are generated by the 
LMJ X11,EDECVS$ proc call: 


ESDECV  addr-of-number 
EFD1$ 
Insert the contents of AO into the image, excluding any sixth word in AO whose 
value is zero (Fieldata at sign ‘@’) or five (Fieldata space, ‘ ‘). This can be used to 
insert a Fieldata name of one word or less, where a partial word filler of zero or 


Fieldata spaces is not wanted in the image. 


L AO,’Fieldata-name’ These two instructions are generated by the 
LMJ X11,EFD1$ proc call: 


ESFD1 ‘Fieldata-name’ 
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mp RS ED I A SEE FL ST EO I TE ESSE TES EE STIG 
EFD2$ 


This is the same as EFD1$, except that it is for a Fieldata name of two words or 
less, contained in AO and Al. 


DL AO,’Fieldata-name’ These two instructions are generated by the 
LMJ X11,EFD2$ proc call: 


ESFD2 ‘Fieldata-name’ 


EMSGS$ 


Insert the characters starting at the address given in AO into the image. This 
process stops when the character in S2 of word O of the EDIT$ packet is en- 
countered in the EMSG$ input string. The pointer for the EMSG$ input string is 
saved in the packet, for possible further use on an EMSGR$ (EMSGS$ reentry) call. 


L,U AO, input-string-addr These two instructions are generated by the 
LMJ X11,EMSG$ proc call: 


E$MSG _input-string-addr 
EMSGRS$ 
Re-enter the EMSG$ subroutine, and begin copying from the EMSG$ input stream 
following the point of previous interruption. With the EMSG$ and EMSGR$§ sub- 


routines, it is possible to copy a string into the image, occasionally interrupting this 
action to perform other EDIT$ functions at certain selected points in the string. 


LMJ X11,EMSGR$ This instruction is generated by the proc 
call: 
ESMSGR 

EOCTF$ 


Convert the number in AO to Fieldata octal digits, and set the result (right-justified 
and zero-filled) into a fixed-length field of the number of characters specified in A1,. 
If the number of Fieldata octal digits (including a leading ‘0’, if the magnitude of 
the number is greater than 7) exceeds the field size specified, truncate one or more 
high order digits. Insert this field into the image. Note that EOCTF$, unlike 
EDECF$, does not assume that the number in AO is necessarily a representation of 
a single positive or negative quantity, and therefore EOCTF$ does not take special 
action to complement the number and add a leading ‘—’ sign if the high order sign 
bit is set. If, for example, AO had all bits set to 1, except bit 0, EOCT$ would 
convert this to the 13-character string, ‘0777777777776', while EDECFS$ would 
convert it to a 2-character string of ‘—1’. 


L,U A1,character-count These three instructions are generated by the 
L AO,addr-of-number proc call: 
LMJ X11,EOCTFS 

ESOCTF  character-count,addr-of-number 
EOCTV$ 
This is the same as EOCTFS$, except the field size is variable, and only as large as is 
necessary to hold the converted Fieldata octal number (including a leading ‘O’, if 
the magnitude of the number is greater than 7). 


L AO,addr-gf-number These two instructions are generated by the 
LMJ X11,EOCTV$ proc Call: 


E$OCTV addr-of-number 
EPACK$ 


This is the same as ECOPYS, except that sixth words whose value is zero (Fieldata 
at sign, ‘@’), although included in the input character count, are not inserted into 


the image. 
L,U A1,character-count These three instructions are generated by the 
L,U AO,addr-of-characters following proc call: 


LMJ X11,EPACK$ 
ESPACK character-count,addr-of-characters 


ESKIP$ 


Advance the column pointer by the column count given in AO. To back up the 
counter, the column count should be loaded negative into AO. 


L,U AQ,column-count These two instructions are generated by the 
LMJ X11,ESKIP$ following proc call: 
ESSKIP column-count 


po a ae ne 


UP—7824 PAGE 3-17 
Rev. 1 UPDATE 


EXEC 8 PAGE 3-18 
Hw/Sw Sum UPDATE 


ETIMES 

Convert the time portion of a TDATE$ format word (see ER TDATES$ — Section 
2) to an eight-character Fieldata string of the form ‘hh:mm:ss’, where hh, mm, and 
ss are the two digits of the hours, minutes, and seconds, respectively. Insert this 
string into the image. 


L AO,addr-of-TDATE$-word These two instructions are generated by the 
LMJ X11,ETIMES proc call: 


ESTIME addr-of-TDATE$-word 


or for the present time: 


ER TDATES These two instructions are generated by the 
LMJ X11,ETIMES proc call: 
E$TD 


EDITS has six subroutines for floating-point editing. They are all very similar. 
The three double-precision surboutines, EFLF2$, EFLG2$, and EFLS2$, are not 
described separately below, since they perform the same operations on a double- 
precision number (in A1 and A2), as the single-precision subroutines, EFLF1$, 
EFLG1$, and EFLS1$, perform on a single-precision number (in Al). The 
double-precision proc calls, ESFLF2, ESFLG2, and ESFLS2, generate a double 
load of A1, rather than a single-word load instruction. 


On entering any of the floating-point subroutines, AO must contain a number of 
the form X*/6+Y, where X is the desired field size and Y is the desired number of 
significant digits. 


The minimum necessary field size to avoid overflow to the right is ¥Y+4, plus 1 for 
each of the following three cases: a separator character is used (see EDITS packet 
fields DPC and SPC); the number is negative (requiring a leading ‘—’ character); the 
number is double precision (which produces a three-digit characteristic) instead of 
single precision (which produces a two-digit characteristic). When the field size is 
larger than is necessary, the edited floating-point result is put in right-justified and 
space-filled. 


EFLF1$ 


Convert the floating-point number in A1 to a Fieldata string in fixed-point format, 
which consists of a leading ‘—' (if the number is negative), a ’.’ to represent the 
decimal point, the number of digits specified by Y, a separator character (if given 
in packet field SPC), a ‘+’ or ‘—’ to indicate that the characteristic is a positive or 
negative exponent, and a two-digit characteristic. Set this string into a field of X 
characters, and insert the field into the image. 


L,U AO,X*/6+Y These three instructions are generated by the 
L A1,addr-of-number proc call: 
LMJ X11,EFLF1$ 

ESFLF1 X*/6+Yaddr-of-number 


EFLG1$ 


This is the most generalized floating-point subroutine. It is the same as EFLF1$, 
except that an attempt is made to shift the decimal point among the significant 
digits in such a way that the characteristic will go to zero, in which case the 
characteristic is set to spaces. If this attempt fails, the decimal point is placed 
following the number of significant digits specified in EDIT$ packet field FPS. 


L,U A0,X*/6+Y These three instructions are generated by the 
L A1,addr-of-number proc call: 
LMJ X11,EFLG1$ 


ESFLG1 X*/6+Y,addr-of-number 
EFLS1$ 


This is the scientific format floating-point subroutine. It is the same as EFLF1$, 
except that the decimal point is always placed following the number of significant 
digits specified in EDIT$ packet field FPS. 


L,U AO,X*/6+Y These three instructions are generated by the 
L A1,addr-of-number proc call: 
LMJ X11,EFLS1$ 


ESFLS1 X*/6+Y,addr-of-number 
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ASCIl IMAGE COMPOSITION EDITING PACKAGE (AEDITS) 


AEDITS is a set of re-entrant subroutines used for composing strings of ASCII characters 
in a user-specified area. The AEDITS package is very similar to the EDITS package 
used for Fieldata images. AEDIT$ is useful in preparing images for: 

(1) Printed ASCII output (ER APRINT$) 

(2) Punched ASCII output (ER APUNCH$) 


(3) Other Executive Requests which require ASCII images 


AEDIT$ works from the following packet. Words 7—10 are used for editing floating- 
point numbers only. 


WORD $1 $2 $3 $4 $5 S6 
(Test and image 
0 qwm length image address 
character word AEMSG$ : 
2 return address for char. store 
4 save of original X2 contents, or save of character pointer 
5 save of original X3 contents, or save of word pointer 
AEMSG$ Stop 
digits digits negative not 
9 
save area for intermediate floating-point results 
10 


@ GENERATING THE AEDITS$ PACKET 


The following PROC call generates a seven-word AEDIT$ packet (for non-floating- 
point routines), where msg = ‘&’ if field 2 is omitted. 


ASEPKT image-length, image-address [‘MSG’,‘AEMSG$-stop’] 


The following PROC call generates an eleven-word AEDIT$ packet (for editing 
floating-point numbers), where the values msg = ‘&’, tos = 1, fpr = 1, dpc = 0, 
spc = O are inserted if the corresponding field is omitted. 


ASEPKTF image-length, image-address [‘MSG’, ‘AEMSG$-stop’] 
[‘FPS’, fps-number] [‘FPR’, fpr-number] 
[‘DPC’, dpc-char] [‘SPC’, spc-char] 


B® ASCII EDITING ROUTINE DESCRIPTIONS 


The AEDITS routines use the same calling sequences as the corresponding EDIT$ 
routines, except for the routine names. To get the AEDIT$ routine name, simply 
add ‘A’ before the name of the corresponding EDIT$ routine (e.g., ECHAR$ be- 
comes AECHAR$). To get the AEDIT$ PROC name, replace the leading ‘E$’ of 
the corresponding EDITS PROC name with ‘ASE’ (e.g., ESSKIP becomes 
ASESKIP). 


NR 
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ASEDIT 


ASEDITX 


AS$EDITR 


ASECHAR 


AS$ECOL 

ASECOLN 
ASECOPY 
ASEDAY 1 
ASEDAT1 
ASEDAY2 
A$SEDAT2 


A$SEDAY3 
A$EDAT2 


ASEDECF 


ASEDECV 


A$SEFD1 


ASEFD2 


ASEMSG 


ASEMSGR 
ASEOCTF 
ASEOCTV 


ASEPACK 


ASESKIP 


ASETIME 
A$SETD 


AEDITS 


AEDITX$ 


AEDITRS 


AECHAR$ 


AECOL$ 


AECOLNS 


AECOPYS 


AEDAY 1$ 


AEDAY 2$ 


AEDAY3$ 


AEDECF$ 


AEDECV$ 


AEFD1$ 


AEFD2$ 


AEMSG$ 


AEMSGR$ 
AEOCTFS$ 
AEOCTV$ 


AEPACKS 


AESKIPS$ 


AETIMES 
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Initial entry into ASCII edit mode. 
The image is space-filled; the column pointer 
is set to column O; quarter-word mode is set; 
X1—X3 are saved. The AEDITS package uses, 
but does not save or restore X11, AO—A3, 
R1. 


Terminate ASCII edit mode. 
Restore X1—X3; save column pointer in 
packet. 


Re-entry into ASCII edit mode. 
Column pointer is restored. 


Edit an ASCII character. 
Insert the ASCII character from Q4 of AO 
into the image. 


Position the pointer to a fixed column. 
Obtain the current column number in AO. 
Copy a string into the image. 


Edit the date portion of AO into the format: 
mm/dd/yy 
(Use ASEDAT1 for the current date) 


Edit the date portion of AO into the format: 
dd mmm yy 


Edit the date portion of AO into the format: 
month dd, year 


Convert to ASCII decimal (fixed length field). 


Convert to ASCII decimal! (variable length 
field). 


Insert ASCII (one word). 
Insert the contents of AO (four ASCII char- 
acters) into the image, excluding any quarter- 
word whose value is 040 (ASCII space) or 
000. 


Insert ASCII (two words). 

This is the same as AEFD1$, except that it 
inserts the contents of AO and At (eight 
ASCII characters) into the image. 


Message editor (initial entry). 

Insert ASCII! characters starting at the ad- 
dress in AQ into the image. This process stops 
when the AEMSG$ stop character (Q1 of 
word 6 of the packet) is encountered in the 
string. 


Message editor (re-entry). 


Convert to ASCII octal (fixed length field). 


Convert to ASCII octal (variable length field). 


Copy and pack a string into the image. 
This is the same as AECOPYS, except that 
the quarter-word whose value is 000, al- 
though included in the character count, is 
not inserted into the image. 


Skip an area in the image (advance column 
pointer). 


Edit the time portion of AO into the format: 
hh:mm:ss 
(Use ASETD for the current time) 
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oe 


AS$EFLF1 AEFLF1$ ASCII single-precision fixed-point format. 
Al is edited to fixed-point format with y 
digits following the decimal point, right- 
justified, in a field of size x, where the call- 
ing sequence is: 


L,U AO,x*/6+y 
L A1, addr-of-number 
LMJ X11, AEFLF1$ 
ASEFLG1 AEFLG1$ ASCII single-precision generalized format. 
ASEFLS1 AEFLS1$ ASCII single-precision scientific format. 
A$SEFLF2 AEFLF2$ ASCII double-precision fixed-point format. 
This is the same as AEFLF1$, except that 
the contents of Al and A2 are edited. 


ASEFLG2 AEFLG2$ ASCII double-precision generalized format. 


ASEFLG2 AEFLS2$ ASCII double-precision scientific format. 
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4. GENERAL ERROR AND 
STATUS INFORMATION 


ERR MODE (EMODE) AND I/O STATUS CODES 


This set of error codes is categorized as being under contingency type 12g. 


Most of these codes relate to errors users make when setting up Executive Requests 
(ERs). The most common user errors are improperly set up, improperly referenced, 
and inadvertently overwritten packets. 


The following list is the full set of defined ERR mode codes, with two exceptions: 
™ §=Type 1 (1/0) codes Og through 17g and 40g are included for the sake of complete- 
ness, even though they represent status conditions that are not necessarily errors, 


and do not directly force a run into ERR mode. 


= Types 6 and 7 (communications) codes are not included because they are lengthy 
and not used by most programmers. 


Code 
Type Octal Description 


1/O (1) The request has been completed normally. If data transfer is 
involved, the count is given in H2 of word 4. 


ADH only — request completed and an interrupt occurred. 
Normal completion is to be determined by the program. 
2 


End-of-file block detected on magnetic tape. 
(a) Answer of E was given to an I/O error message. 
(b) End-of-file block was detected on magnetic tape. 


{c) Block read drum function was truncated by encounter- 
ing an end-of-block word. 


(d) Block search read function was truncated by encounter- 
ing an end-of-block word before the specified number of 
words were transferred. 


ADH only — the specified time interval has expired without 
an interrupt occurring. The operator response to the timeout 
message is in the Al register in Fieldata (B, D, E or G) if the 
timeout field (S3 of word 4) is zero (an A response is not 
recorded). Otherwise the A1 register is set to zero and no 
timeout message is displayed. 


End-of-tape mark encountered on magnetic tape on a read 
backward from load point or on a write. No transfer takes 
place for the read backward. The write is done in the normal 
manner. Subsequent writes are performed in the same fash- 
ion and, barring other problems, result in returning the same 
status code. 


No find was made on a mass storage device search. The 
search was terminated by an end-of-block, end-of-track, end- 
of-position, or expiration of sufficient time to pass over the 
entire area of concern depending upon the physical device 
and type of search. , 


A nonintegral block was read from magnetic tape. The num- 
ber of data characters accepted from the last word is indicated 
by S3 of word 4 of the packet. 


An attempt was made to initiate a mass storage search or read 
from an area which is wholly or partially unassigned. If the 
starting address is legal the read is truncated as reflected by 
the word count in the substatus field. An absolute read re- 
quest was issued specifying an illegal mass storage address. 


The area of the FASTRAND mass storage file being unlocked 
by this write or unlock request timed out in the locking list. 
Other requests by other activities for the area may have been 
honored in the interim. If the function is write, the transfer 
is not performed. 
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Code 
Type Octal Description 


1/0 (1) A nonrecoverable error has occurred. The suppress recovery 
mode is set for magnetic tape or an answer of G was given to 
an error message. If the suppress recovery mode is set, the 
El status code is stored in Al of the interrupt activity con- 
trol register set. All suppress recovery operations come back 
with this status. 


A read, or write error on magnetic tape has resulted in loss of 
position on the unit. This code is returned for all outstanding 
requests at the time the answer of B was entered in response 
to the I/O error message. Any subsequent request is honored 
but no further program checkpoints are valid. 


For mass storage devices this status indicates a bad spotted 
granule was encountered in the file or an answer of B was 
given to a mass storage |/O error message. 


The peripheral unit was declared down by an unsolicited 
operator keyin. 


Some form of write or a function causing area release was at- 
tempted on a file assigned in the read-only mode, or a form of 
read was attempted on a file in the write-only mode. 


An attempt was made to reference a filename for which no 
assignment has been made. 


ADH only — EF buffer control word length greater or less 
than that allowed for device being accessed, or the file 
specified in the packet is not assigned to the program. For 
MSA devices when one function operation has been found 
and a second function operation is indicated. 


An attempt was made to write beyond the maximum assigned 
space (via @ASG) for mass storage file or to expand a word- 
addressable format file when no space is available. 


ADH only — equipment being referenced is not allowed for 
ADH interface. 


The packet address specified in the AO register is not within 
the program limits or defines a packet split between the in- 
struction and data banks of the program, or defines a packet 
in a write-protected bank. 


The function code is not defined for the assigned equipment 
type. This code also covers noncompatible fields on a set 
mode request. An absolute read or write was attempted by 
user program. 


ADH only — illegal value in command string or, if device 
being referenced is attached to an MSA, the M field in the 
MSA command string was found set. 


The 1/O access word refers to a buffer which is wholly or 
partially outside of the program area or split between the 
instruction and data bank of the program. For GW$, SCR$, 
and SCRBS$ functions, this error code is given if the number 
of access words is O or more than 50 or if the total word 
count is more than 65535. 


ADH only — if device being referenced is attached to an 
MSA, a monitor operation was encountered in the string. 
Otherwise an access word within the packet was found com- 
pletely or partially outside of program limits. 


Illegal starting address given for an interrupt activity. This 
also covers the case of the last mode being with monitor but 
no monitor interrupt activity specified. 


An t/O request was made with the status word of the request 
packet set negative indicating a possible program loop. 


A magnetic tape operation was issued with user recovery 
specified and an interrupt activity was not specified (that is, 
entrance was not made via |OI$, |OXI$ or JOWI$). 


A FASTRAND-formatted or word-addressable !/O request 
may cause the PCT to expand past its maximum. The I/O 
request is not initiated. 
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; Code 
Type Octal Description 
4 
5 
6 
0 
2 


An absolute read or write was attempted on an illegal unit 
or subsystem. 


Errors on read and lock, and unlock requests: 


(a) A second read and lock (RDL$) request by an activity 
for a particular area. 


(b) An unlock (UNL$) request for an area that the activity 
had not previously locked. 


Errors on WAITS requests: 


(a) No !/O is outstanding for this packet. 


(b) WAITS request was not immediately preceded by a Test 
Positive instruction or the Test Positive instruction had 
a nonzero h or i field. 


(c) A WAITS or WANY$ request was made without a pre- 
vious outstanding 1/O request for the program. (The 
executive tests for the case of |/O completion between 
the time the ER is initiated and the time it is processed 
without error notification.) 


The request is either in the process of being executed or is 
listed on the request queue for the particular channel. 


1/0 (1) 3 
3 
3 
4 


Second abnormal return from READ$ or AREADS$. 


1/O error (READ$, AREAD$, READA$ or AREADAS). 


Image length error. 


@ADD error, run stream. 
READS or AREADS access word failure. 


Improper SDF control image, READ$, AREAD$, READA$ 
or AREADAS request. 


Attempt to @ADD an element from tape. 


Nested level exgeeds maximum (@ADD). 


@ADD fite not assigned or catalogued. 


@ADD element not found in file. 


Nested @ADD loop. 


@ADD file equipment type error. 


Cannot assign @ADD file because PCT is at maximum size. 


Alternate file not assigned for demand or real-time run. 


Cannot assign punch file or alternate print file. 


Type of call does not match type of file. 


Alternate packet out of limits. 


Read alternate file not assigned. 


Error on first read from read alternate. 


Alternate file not FASTRAND or tape. 


Maximum number of active alternate files exceeded. 


Maximum number of breakpoints for print or punch ex- 
ceeded. 


Buffer out of limits. 


MAX pages. 


MAX cards. 
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Code 
Type Octal Description 


SYMB 43 legal syntax in control image. 
aa 44 Maximum length exceeded on control image. 
45 1/O error on creating output file for breakpointed or al- 
ternate print/punch file. 
46 Read alternate !/O error. 


ER (04) 1 ER index out of range or ER for executive only. 


Bad packet limits on ER. 
ER index within range, but not in use. 
Error encountered on AWAITS request. 


Bad activity number (id) specified on FORK$ request. 
Either out of range or already in use. 


Account number does not permit requested real-time priority 
(RT$, FORK$). 


Invalid queue pointer or TS cell location encountered in Test 
and Set Queuing. 


FACIL$/FACIT$/FITEM$ packet failed access word check. 


FACIL$/FACIT$/FITEM$ I/O error or PCT name section in 
error. 


Bad BBEOF$ packet or invalid file control table address. 


File not catalogued or file not mass storage FASTRAND for- 
mat. 


\legal creation of real-time activity via FORK$ request. 


A specified activity name cannot be found in the activity 
name table on a NAME$, ACTS, INT$, or DACTS request. 


There is already an II activity specified. 


Attempt to set quarter-word mode via ER PSR$ when 
quarter-word mode not allowed on system. 


Filename not assigned for tape swap. 


Syntax error on CSF$ image. 


CSF$ image length is greater than 40 words. 

Illegal command for CSF$. 

Image is outside user’s program limits. 

Log entries for this run exceed MAX allowed by CSF$. 

ER ABSAD$ not allowed under the run’s account number. 


Invalid input parameter to LOAD$ (A1,H1 or A2,H1 non- 
zero). 


1/O error encountered when loading segment. 

Request to load an undefined segment. 

Invalid information in segment load table. 

Input parameter contains common BDI, out-of-range BDI, 
or an address less than the lowest address of the specified 
bank on ER MCORES. 

Input parameter contains common BDI, out-of-range BDI, 
or an address less than the lowest address of the specified 


bank on ER LCORES. 


MCORES request for core not available. 


AS PES TE SE aT I SE, EB ED EE ST IE i IT TE SEED 


UP—7824 
Rev. 1 


EXEC 8 
Hw/Sw Sum 


Code 
Type Octal Description 


Attempt to release communications buffer pool with ER 
LCORE$. 


Bad packet on ER SNAP$. 
AO was negative on SETBP$ request. 


Relative breakpoint address outside user’s program limits on 
SETBP$ request. 


“P” bit set in conjunction with “R” or “W" on SETBP$ 
request. 


Bit 34 set on breakpoint parameter for SETBPS$ request. 


Attempt to load a segment into a nonbased dynamic bank, 
or the program control bank is a nonbased dynamic bank. 


An ACW in the absolute element is wholly or partially out- 
side of the bank limits. 


Bad LIJ/LDJ. No bank currently assigned with index 
specified by LIJ/LDJ instruction or, captured P not equal 
to collector defined entrance to a guaranteed entry bank. 
Processor requested on ADED$ call is not available. 

Packet not within limits. 

Output buffer not within limits. 

Expected input count exceeds 50 characters. 

Input buffer not within limits. 

RLIST$ packet not within program limits. 


LINK$ or RLIST$ request and REP’s entry point is zero. 


RLIST$ request and either the file is not assigned or not on 
mass storage. 


RLIST$ entry name not found. 
REP contains D bank addresses. 


Bank Description Table (BDT) and extensions (BDTE) exceed 
system maximum (511 words) after RLIST$ request. 


RLIST$ request to remove previous REP list with REPs 
active. 


LINKS or RLINK$ request and specified name not found by 
system's search. 


EXLNK$ or UNLNK$ request not from linked routine. 
Number of RLIST$ REP names exceeds system’s maximum. 


A LINK$, RLINK$, or RLIST$ request and no PCT space 
available. 


A LINK$, RLINK$, or EXLNK$ request and system de- 
tected an !/O error in loading a REP. Or an t/O error re- 
loading the REP after its storage had been released for time- 
sharing. 


The main program plus the REP’s main storage requirements 
exceed total user main storage. 
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CONTROL STREAM DIAGNOSTIC MESSAGES 


The following messages are among the most common and typical of the many hundreds 
in the system. A large number of other messages are worded somewhat differently, but 
have meanings which are similar to these. 


When a code from 1g to 37g is contained in an error message, it often points to one of 
the I/O problems described under type 1, ERR MODE (EMODE) AND I/O STATUS 
CODES. Note that most of the messages issued by the FURPUR processor correspond 
to a specific 1/O error and status code. 


When a twelve-octal-digit status code is given in an error message, it often has bit 
settings corresponding to one or more of the causes of facilities rejection (FAC REJECT) 
or facilities warning (FAC WARNING) described at the end of this section. 


Some diagnostic messages refer to operator keyins. Here are the usual meanings of the 
most common keyins: 


A Try again with standard recovery. L = _ Lock out a symbiont. 

B Return t/O status 12 to packet. N_ The reply is ‘‘no.”’ 

D_ Declare device down. Q_ Re-enter a symbiont file in its ap- 
propriate queue. 

E Treat as end of file, or error off a 


run. Reprint or repunch a symbiont file. 

G Treat as unrecoverable error, since 
1/O device positioning appears to be 
good. 


Suspend a symbiont. 
Terminate a symbiont. 


I Initiate a locked out or suspended 
symbiont. 


Abort a symbiont, or abort a run. 


< x 4A YW Dw 


The reply is ‘’yes.’’ 


One of three abbreviations, S! (source input), RO (relocatable or absolute output), 
or SO (source output), is frequently used to identify the element named in the corres- 
ponding specifications subfield of a processor call statement, such as @ASM, @COB, 
@FOR, or @MAP. For processors such as @ELT which have no RO subfield, only SI 
and SO are meaningful. 


® DIAGNOSTIC MESSAGES 

The self-explanatory messages are not included. 

The run stream diagnostic messages are: 

—@@COMPLETE 

Normal completion of processing on a transparent control statement has taken piace. 
—@@ERROR (error codes) 


—@@ERROR — ILLEGAL TYPE 
—@@ERROR — SYNTAX 


These three messages indicate that an error was encountered while processing a trans- 
parent control statement. The error codes are the same codes returned on a dynamic 
request of the control statement. 


AT LEAST 1 PRINT IMAGE HAS BEEN TRUNCATED 


An image length error occurred during file output and the attempted recovery was 
successful. 


AWAIT/DEACT AMBIGUITY 


The executive determined that all activities of the run were either in an AWAIT state 
(ER AWAIT$), a DEACT state (ER DACT$), an II$ wait state, or a Test and Set 
Queuing wait state and could not be activated by the run. 


BAD INPUT SEQUENCE 


The input control message was rejected because it conflicts with the current status of 
the run. 


BRKPT 


User’s breakpoint setting matched and no contingency was registered. 
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CANNOT SYM PUS WHILE IN USER FILE 


Caused by @SYM PUNCH$,,CP control statement when the current PUNCHS$ file has 
been @BRKPT‘d to a user file. 


CONTROL REGISTER VIOLATION (1110 Only) 
The user attempted to reference EXEC GRS. 
x CYCLE SPECIFICATION IGNORED 


RO or SO cycle specification is meaningless and is ignored. Does not cause error 
return. 


DATA IGNORED — IN CONTROL MODE 


Data statements were encountered when the EXEC was attempting to read control 
statements; that is, a program or processor was not in control of the run at the time 
these statements were encountered. 


DBANK CANNOT BE LOADED WITH NEGATIVE BD 

DBANK RELATIVE STARTING ADDRESS = OsssO00, DBANK SIZE = Onnn000, 
LAST ADDRESS OF USER CORE = Oxxx777. 

The program cannot be loaded without causing BD to become negative. This is the 
result of using a SETMIN directive to specify a minimum starting address for the 
DBANK. See UN/VAC 1108 Processor and Storage Programmer Reference, UP-4053 


(current version), or UN/IVAC 1110 System Processor and Storage Programmer Ref- 
erence, UP-7970.1 (current version). 


ELEMENT UNOBTAINABLE xx 


The element specified on the @START control statement cannot be found. xx is a 
program file search code. 


@END IGNORED — IN CONTROL MODE 

An @END control statement was encountered when the EXEC was attempting to read 
control statements; that is, the DATA OR ELT,D processor was not in contro! of the 
run at the time this statement was encountered. 

@EOF IGNORED — IN CONTROL MODE 

An @EOF control statement was encountered when the EXEC was attempting to read 
control statements; that is, a program or processor was not in control of the run at the 
time this statement was encountered. 

EQUIPMENT TYPE ERROR, ADD FILE 

ADD file was not in FASTRAND format. 

ERROR — DYNAMIC DUMPS NOT CLOSED 

1/O error encountered when writing system diagnostic file (DIAG$). 

ERROR ENCOUNTERED WHILE OUTPUTTING FILE 

An I/O error occurred with a code of 4g, 11g, or 12g and the inhibit recovery flag had 
not been set by an ER PRTCN$. The message is displayed if the recovery process is 
successful or if the operator did not terminate the file. 


ERROR LOADING PROGRAM 


An error was detected in the absolute element. Bad element or the element is possibly 
destroyed. 


FAC REJECTED xxxxxxxxxxxx 


This message appears for a run that aborted due to a facility control statement that 
cannot be honored by the system. 


FAC WARNING xxxxxxxxxxxx 
This message is a warning that the facility control statement could cause a problem. 
FILE ALREADY IN USE 


@BRKPT control statement issued for a file currently being used as a symbiont file not 
capable of being @BRKPT‘d (e.g., an @ADD file). 
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xX FILE CANNOT BE READ 


Input file is in read inhibited mode due to absence of read key, write-only mode set for 
file, or Y option used on the file assignment. 


FILE ERROR 


The file requested on a @XQT or processor control statement could not be assigned or 
is not a program file. If the run is not demand, it is terminated. 


FILE FORMAT ERROR. FILE TERMINATED 

An image length error occurred and the | function was set. 

FILE FORMAT ERROR. TERMINATED BY OPERATOR 

An image tength error occurred and the operator did not try recovery. 
x FILE NOT FOUND ~— STATUS: n 


File x is neither assigned to the run nor catalogued. n is the status returned when an 
attempt was made to assign file x. 


FILE STMT «* FACILITY REJECT «#* xxxxxxxxxxxx 


If for some reason the processing of the @FILE statement by facilities was in error, this 
message is given, where the 12-digit code is the facilities status word. 


FILE STMT * FORMAT ERROR* 


The format of the @FILE statement is not consistent with predefined format specifica- 
tions. 


FILE UNOBTAINABLE xxxxxxxxxxxx 


The file specified on the @START control statement cannot be accessed by the execu- 
tive. XxXXXXXXXXXXX¥ is a 12-digit octal status code returned when the file cannot be 
assigned. 


FIRST FILE NAME IS IN ERROR 


First file name was not given for @BRKPT or @SYM control statement, or a @BRKPT 
control statement was for an inactive alternate file. 


This message will also be printed if the D option is specified on a @SYM control state- 
ment and the filename specified is not the generic name PRINTS. 


nn \LLEGAL CHARACTER x 


The coarse scheduler encountered an illegal character x at column nn of the above con- 
trol statement. 


ILLEGAL COMMON BANK BDI iii 
A common bank BDI number i// referenced by the program is invalid. . 
ILLEGAL CONTINUATION 


Continuation of the above control statement is not allowed or the next control state- 
ment has the control character ( @ ) in the first column. The control statement is not 
honored and the run is terminated (if it is not a demand run). 


ILLEGAL ENTRY POINT TO A GUARANTEED ENTRY COMMON BANK 


The entry point specified by the user program is not that of the guaranteed entry com- 
mon bank which is initially based; or more than one guaranteed entry common bank is 
initially based. 


*ILLEGAL EQUIP ON @FILE* 


A file was assigned of the wrong device type. The user's read file is closed with a @FIN 
control statement, the run is marked as removed and the file from the first @FILE 
control statement ts not catalogued. 


** ILLEGAL EQUIP TYPE ON FIRST FILE ** 


The device type on the first @FILE control statement did not specify tape equipment. 
This may be encountered when processing multiple @FILE control statements, cr when 
a‘T’ option is found on the @FILE control statement for a mass storage file. 
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x ILLEGAL DEVICE 


Output file is not FASTRAND format or input file is neither tape nor FASTRAND 
format. 


x ILLEGAL FIELD 


Field is ambiguous with option given (for example, | option specified and source 
output field coded). 


ILLEGAL LIJ/LDJ INSTRUCTION 
STATUS WORD = xxxxxx 


On an LIJ or LDJ instruction, the user had either an E-bit violation or table length 
violation. xxxxxx of the status word will be bits 35—18 of the undefined sequence 
interrupt status word. 

nn ILLEGAL OPTION x 


An illegal option x was encountered at column nn of the above control statement. The 
control statement is not honored and the run is terminated (if it is not a demand run). 


IMAGE IGNORED — TRANSP CTL IN PROGRESS 


A transparent control statement has been rejected because another transparent control 
statement from this terminal is currently being processed. 


IMPROPER RUN STREAM IN FILE 


The first image in the file or element specified on the @START control statement is an 
invalid @RUN control statement. 


INVALID SYMBIONT NAME 
@SYM file is directed to an illegal or non-existent device or group. 
1/0 ERROR ENCOUNTERED 


The executive returns this message after receiving an error code while trying to read the 
file specified on the @START contro! statement. 


1/0 ERROR xx. FILE TERMINATED 

An I/O error occurred which is not one of the recoverable types (4g, 11g, and 12g). 
I/O ERROR IN TERMINATION — PMD NOT INITIALIZED 

1/O error encountered when writing system diagnostic file (DIAGS$). 

I/O ERROR xx. TERMINATED BY OPERATOR 

An !/O error occurred and the operator terminated the file. xx is the error code. 

1/U OPTION CONFLICT 

Both | and U options given on processor contro! statement — ambiguous options. 
LABEL FORMAT ERROR 

User tried to illegally access a labeled tape or hardware error occurred when trying to 
validate a tape/disc pack label. Also, operator responded E to a request to mount a 
disc pack or tape. 


LAST REL |—-BANK ADDR GTR ‘0177777’ 


The hardware field ‘BS’ in the PSR has 7 significant bits. This field is meaningless if 
set above 0177777. 


LIS LEGAL FOR TAPE ONLY 


The L option was specified on the @BRKPT control statement and file does not reside 
on tape. 


MASS STORAGE OVERFLOW 
Mass storage request cannot be satisfied because mass storage is not currently available. 
nn MAX NUMBER OF CHARACTERS EXCEEDED 


The character at column nn of the above control statement is not a field/subfield ter- 
minator and the maximum number of characters for this subfield has been reached. 
The control statement is not honored and the run is terminated (if it is not a demand 
run). . 
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nn MAX NUMBER OF FIELDS OR SUBFIELDS EXCEEDED 


The character at column nn of the above contro! statement is the field terminator and 
no more fields are allowed for the control statement, or the character is a subfield ter- 
minator and no more subfields are permitted for that particular field. The control state- 
ment is not honored and the run is terminated (if it is not a demand run). 


NO FILE SPECIFIED 
File name is not specified on a @START control statement. 
NO RUN ACTIVE 


Applies only to demand processing — message appears on demand terminal if statements 
are entered before the @RUN control statement. 


NO SPACE FOR MAJOR SAVE ON ABORT$ CONTINGENCY 


No space available in PCT for register save when processing an ABORTS$ contingency. 
Run is terminated. 


NON-ZERO !/O STATUS FROM USER FILE ss 


A bad |/O status was returned after an 1/O request on the user’s file. The file has been 
destroyed or there is incorrect data in the absolute element. 


OPERATION IS ILLEGAL FOR DEMAND 


@BRKPT PRINTS or @BRKPT PRINT$/PRINTS$ control statement from a demand 
terminal before @BRKPT PRINTS$/file. 


filename OUTPUT FILE !S TAPE 
Output file should be FASTRAND format and is tape instead. 


*** PARITY ERROR *** 


A parity error has been detected in at least one character of the input image. The entire 
image is discarded. (For teletypewriter only.) 


PCT EXPANDED BEYOND SYSTEM LIMITS 
The number of main storage blocks required for expansion of this run’s PCT exceeds 
the system generation parameter PCTMAX. When a run aborts with this message, a 


postmortem dump of the PCT (obtained using @PMD,P) may show one of the following 
to be the cause: 


(1) Excessive number of granule tables (change track granularity to position granularity) 
(2) Excessive number of activities (check for ER FORK$ loop) 

(3) Excessive number of files assigned (check for ER CSF$ loop) 

PCT OVERFLOW ON INITIAL LOAD 


The total number of PCT blocks requested is greater than the system‘s generation 
parameter PCTMAX. This message is specifically given during an initial load. 


PCT/PROGRAM SIZE EXCEEDS USER CORE 


Either an internal main storage bank has been downed so the program does not fit or a 
real-time program has started and this program is too large to fit the available main 
storage. 


PMD NOT ALLOWED 


Postmortem dump is not allowed for a system processor (called from the SYS$*LIB$) 
unless a Y option appeared on the @RUN control statement. If an N option appeared 
on the @RUN control statement, no postmortem dumps of any programs are allowed. 


PRIVILEGED INSTRUCTION VIOLATION (1110 only) 
The user attempted to execute an EXEC-only instruction. 


PROGRAM NOT FOUND 


The requested program or processor is not in the given file, LIB$, or TPF$ (depending 
on the statement). If the run is not demand, it is terminated. 


PROGRAM TOO LARGE PROGRAM SIZE nnn BLKS. 
CORE SIZE xxx BLOCKS. 


The program is too large to fit in the space available to user programs. The program 
requires nnn main storage blocks and user main storage consists of xxx main storage 
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blocks. A main storage block is 51249 (1000g) words and the sizes nnn and xxx are 
octal numbers, thus giving the sizes in octal 1000's. 


x READ ONLY OUTPUT FILE 


Output file is in write inhibited mode, due to absence of write key, read-only mode set 
for file, or Y option used on the file assignments. 


REAL TIME PROGRAM ATTEMPTED PCT EXPANSION 


A PCT expansion attempt for a real-time program could not be done. If the program 
expects PCT expansion it should use a @RUN control statement option to initialize 
PCT size so expansion is not attempted. 


nn REQUIRED FIELD OR SUBFIELD MISSING 

A field or subfield which is required on the above control statement has not been 
specified. The omission was detected when the field/subfield terminator or the end of 
the control statement was encountered at column nn. The control statement is not 
honored and the run is terminated (if it is not a demand run). 


RUNSTREAM ANALYSIS TERMINATED 


The run has been terminated because of an error condition and the remaining control 
statements are not processed. 


SECOND FILE NAME IS IN ERROR 


Caused by second file name on @BRKPT control statement not currently assigned to 
the user. 


SECOND @FILE STATEMENT FORMAT ERROR 

A syntax error was encountered on the second @FILE control statement. SECOND 
here implies that one or more @FILE control statements have already been processed. 
The user’s read file is closed with a @FIN control statement, the run is marked as re- 
moved and the file from the first @FILE contro! statement is not catalogued. 

SECOND NAME IS [ILLEGAL 


Second file cannot be given on a @BRKPT of a read alternate, print alternate, or punch 
alternate file. 


Sl: CYCLE NON-EXISTENT OR IN ERROR 
Requested cycle of specified element does not exist or cycle field has improper format. 
SI: ELEMENT NOT FOUND 


Element name given cannot be found as a symbolic element in the specified program 
file. 


Sl: IMPROPER LABEL BLOCK 


Source input file is tape, and tape is not positioned at the label block for requested 
element, probably because a @FIND has not been done. 


SI: MISSING FIELD 
A field of required information (for example, element name) was not given. 
SIRASM EDIT ERR cre 


Line correction diagnostics produced by SIRASM in the edit mode. 


where: 
c -— Indicates the cause of the error. A list of possible causes is shown below. 
r — First four words of the range correction statement under whose control 
the error occurred. 
e — Specifies the change correction statement that caused the error. 


Q SEPARATOR — The separator used in the change correction 
statement is invalid or nonexistent. 


QO COLUMN — The column number specified on a format 1 or 
2 change correction statement is out of range, 
or that C > D for a format 2 change correction 
statement. 
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QO NOFIND — The characters given in the old data parameter 
of a format 3 or 4 change correction statement 
could not be found in the line being corrected. 


NOTE: 


Whenever one of the above errors occurs, the change correction state- 
ment is ignored and the line remains unchanged. 


Q ASCII MODE — Indicates that symbolic input or output is in 
ASCII code, or that the user requested ASCII 
code. Since SIRASM cannot correct ASCII 
code, all range and change correction state- 
ments are ignored. 


O CARD COUNT <— _ Not enough change correction statements were 
provided. Those lines for which no change 
correction statement was provided remain un- 
changed. 

OQ CARDCOUNT>— Too many change correction statements were 
provided. The excess change correction state- 
ments were ignored. 

STORAGE LIMITS/WRITE PROTECT VIOLATION (1110 only) 


The user attempted to reference an area outside his limits or attempted to write into a 
read-only area. 


TAPE IMAGE LOST* REREAD 


Applies only to demand terminals — indicates that images were lost while inputting 
images in form Il paper tape mode. 


TAPE OR TEMPORARY FILE NOT ALLOWED 


The user attempted to perform a @START of a run stream on a tape file or temporary 
file. 


TIME OUT WARNING 


No activity has occurred on the line for a predefined interval. 1f another time interval 
elapses without activity, the terminal is terminated. 


TIMEOUT ON INTERRUPT LOCKOUT (1110 only) 


The user was taken to guard mode interrupt because interrupts were locked out for 
more than 100 usec. 


TOO MANY COMMON BANKS DEFINED 
The number of common banks referenced by this program is greater than 1500 decimal. 
TOO MANY USER BANKS DEFINED 


The number of user banks defined for this program is larger than the maximum allowed, 
250 decimal. 


UNRECOVERABLE I/O ERROR WHEN READING FILE filename 


The coarse scheduler encountered an unrecoverable I/O error when searching file fi/e- 
name for a program or processor. If the run is not demand, it is terminated. 


**WAIT LAST INPUT IGNORED** 


Applies only to demand terminals — indicates that the system is not ready for further 
input, 


WARNING IMPROPER OPTION 


Caused by @SYM,C control statement with printer symbiont name (warning only). 


FACILITY REQUEST STATUS CODES 


If a facilities request made by one of the facilities control statements (@ASG, @MODE, 
@CAT, @FREE, and @USE) is found to be in error, a status word is generated in which 
the various bits set define the error. For incorrect facilities control statements sub- 
mitted in the run stream, the status word is given as part of the FAC REJECTED ...or 
FAC WARNING . . . message. For control statements submitted by a CSF$ request, 
the status word is returned in register AO. 
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35* Request not accepted; check other bits for reason. 

34* Field error in control statement other than syntax. Option conflict 
(MHL, OE, or |B) or noise constant specification error. Requested hard- 
ware not currently part of the system. 

File is already assigned for @ASG or @CAT control statement specified, 
already freed for the @FREE control statement specified, or not assigned 
for the @MODE control statement specified. This setting is fatal for 
@CAT and @MODE control statements. 

The file was previously catalogued. 

Equipment type specified on @ASG control statement is not compatible 
with catalogued type or file specified on @MODE control statement is 
not magnetic tape. 


Not used. 


The portion of the filename used as the internal name for I/O packets is 
not unique. 


Not used. 
Incorrect read key for catalogued file. 
Incorrect write key for catalogued file. 


Write key that exists in the master file directory is not specified in the 
@ASG control statement (file assigned in the read-only mode). 


Read key that exists in the master file directory is not specified in the 
@ASG control statement (file assigned in the write-only mode). 


Read key specified in the @ASG control statement; none exists in the 
master file directory. 


Write key specified in the @ASG control statement; none exists in the 
master file directory. 


An ‘A’ option was specified in the @ASG control statement and the file- 
name cannot be found in the master file directory. 


Invalid reel number specified in the @ASG control statement for a 
catalogued tape file, or pack-id for catalogued removable disc file. 


Mass storage file has been rolled out. 

Request on wait status for facilities. For a tape file, this usually means a 
tape unit is not currently available. For a drum file, this usually is caused 
by an exclusive use conflict with another concurrent run. 

Option conflict for catalogued files, either the D and K options were 
specified or C or U, or P, R or W in combination with C or U was 
specified for a file which already exists in the directory. 


File assigned exclusively to another run. 


Find was made on a catalogued file request and the file was already 
assigned to another run. 


File to be decatalogued when no run has file assigned. 


Project-id incorrect for catalogued private file. 
Equipment is tape. 

Read-only file catalogued with an R option. 
Write-only file catalogued with a W option. 
Equipment requested is down. 


File specified in an @ASG control statement is disabled because the links 
pertinent to its master file directory items have been destroyed. 


File specified in an @ASG control statement has been disabled because 
the file was assigned write-enabled during a file recovery. 
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Os 


File specified in an @ASG control statement has been disabled because 
the file has been rolled out and the backup copy is unrecoverable. 


F-cycle conflict 


(a) Cataloguing of the requested F-cycle would force deletion of a 
currently assigned F-cycle. 


(b) F-cycle generation inhibited due to existence of +1 file. 


(c) F-cycle requested is not within the currently acceptable range. 


Reserved for future use. 


“Request was rejected. If request was submitted by the run stream, this results in 
a FAC REJECTED message and termination if a batch run (results in only a FAC 
REJECTED message for demand runs). For dynamic requests through a 
CSF$ request, bit 35 is set in the status word returned in register AO. 


tif the statement was submitted by a CSF$ request, the run is aborted and no 
status word is returned in register AO. 
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5S. DEMAND PROCESSING 


The executive supports the use of the following terminals to access the system in the 
demand mode: 


(1) UNISCOPE 100 Display Terminal 
(2) UNISCOPE 300 Visual Communications Terminal 
(3) UNIVAC DCT 1000 Data Communications Terminal 


(4) UNIVAC DCT 500 Data Communications Terminal (Teletypewriter and Semi- 
automatic Mode) 


(5) Teletype Models 33, 35, 37, and 38 (KSR and ASR) 


(6) Friden Model 7100 Typewriter 


GENERAL DEMAND TERMINAL OPERATIONAL PROCEDURES 
@ INITIALIZATION 


Before the demand terminal can be initialized, the user must turn it on, set the various 
switches to the proper position, and establish the proper line connection if operation 
is on a switched line network. 


Once the connection is made and the terminal is initialized, the demand user must send 
a six-character remote site-id to the operating system. 


The site-id submitted by the demand user is compared to a list of valid site-ids and if 
the system responds with the message: 


UNIVAC 1100 TIME-SHARING EXEC VER xx.xx.xx 


The demand user can assume that the initialization operation is completed (xx.xx.xx is 
the version of the UNIVAC 1100 Series Operating System operational at the central 
site). 


8 DEMAND TERMINAL MODES OF OPERATION 
The demand terminal has three distinct modes of operation: 
(1) Terminal Inactive Mode 


This is the initial mode of the terminal following the sign-on procedure. The 
terminal will return to this mode at the completion of the other two modes. 


(2) Demand Run Mode 


This mode is achieved by submitting a @RUN control statement from the primary 
input device, that is, the keyboard. In demand mode, the input will be solicited 
when input is desired by the executive. The terminal is returned to the inactive 
mode by submitting a @FIN control statement. Another @RUN control statement 
will not be accepted while in the demand run made. 


(3) Remote Batch Mode 


The demand terminal may be switched from the terminal inactive mode to the 
remote batch mode for input or output. 


The ‘B’ option on the @RUN control statement (@RUN,/B) will place the terminal 
in the remote batch input mode. Input will not be solicited as in demand run mode. 
The terminal will be returned to the terminal inactive mode following a @FIN 
control statement. Another @RUN control statement will be accepted while in the 
remote batch input mode and will be treated as another remote batch run whether 
it contains a ‘B’ option or not. Output files generated by the remote batch run as 
well as those SYM’d (via @SYM) to the terminal can be displayed at the terminal 
by entering the statement, @@SEND. This mode can be achieved only from the 
terminal inactive mode. The terminal is returned to the terminal inactive mode 
when the output process of the file is complete. 


= DEMAND SYMBIONT CONTROL STATEMENTS 


Control of demand symbionts is regulated by control statements prefixed with a 
double master space (@@). 


These control statements do not require the input solicitation. They may be entered 
after an output interrupt (break-key) or any other time the terminal operator finds the 
need. Each demand symbiont may have control statements for its individual features. 


ge a eS OS GEE I SE FEE PE TE a IE TIN SIE EET 


UP—7824 PAGE 5-1 
Rev. 1 UPDATE 


EXEC 8 PAGE 5-2 
Hw/Sw Sum UPDATE 


@@X TIOC The @@X statement directs the executive 
to take action on any or al! of the four pos- 
sible action parameters. 


Demand Run — terminate the demand run’s present 
execution. 


Demand Run discard all backed-up input. 


Demand Run discard all backed-up output. 
Remote Batch 


Demand Run — generate a ‘BRK’ contingency. 


@@SKIP n Demand Run Skip n lines of output where n is a value of 
Remote Batch 0 to 63. The SKIP may be reset by a 
@@SKIP 0. 


@@SEND Terminal Inactive Send any queued batch output file to the 
terminal. 


@@ROQUE Remote Batch Stop the present batch output file and re- 
Queue it for a later @@SEND request. 
Return to terminal inactive mode. 


@@CONT All Directs the symbiont to continue. Useful 
after a BRK-KEY when no action is desired. 


@@CQUE Demand Run Circumvent input solicitation requirement. 
Allow several input images to be buffered in 
memory before the terminal is placed in the 
wait condition. 


Directs the executive to buffer all input to 
mass storage until the @@END control 
statement is received. If the @@INO state- 
ment is entered in terminal inactive mode, 
the next input should of course be a @RUN 
statement. All run statements entered while 
in @@!INQ mode will be considered remote 
batch and not demand. 


Terminates special input mode, i.e., 
@@CQUE or @@INQ. The @@END returns 
the terminal to demand run from @@CQUE 
and will begin processing the mass storage 
buffered input for @@INQ. 


Demand Run Allows the input to be passed to the 
requestor unaltered from the format of 
which it was entered; that is, all communica- 
tion envelope characters are not removed 
nor is the image translated. 


@@TERM Directs the executive to terminate the 
terminal. It is recommended that the remote 
operator enter @@TERM only while in 
terminal inactive mode. However, if entered 
while a run is active, the run and terminal 
will be terminated. 


@ DEMAND TERMINAL TERMINATION 

The standard termination procedure is performed when a @FIN control statement is 
received by the system. The executive retains control of the line terminal until! all out- 
put destined for the site has been processed. 


The symbiont then returns to the system command mode. Either another @RUN con- 
trol statement or the termination sequence, @@TERM should follow. 


TELETYPEWRITER/DCT 500 SYMBIONT 


The TTY/DCT 500 symbiont provides support for Teletype Models 33, 35, 37 and 38 
(KSR/ASR), Friden* Model 7100, and the DCT 500 operating in teletypewriter or semi- 
automatic mode. 


*Trademark of Friden Division of Singer Company 
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m@ PAPER TAPE OUTPUT OPERATIONS 


No special effort is required to force output to paper tape on TTY mode devices. All 
that must be done is to turn on the paper tape punch and output will occur on both 
the printer and the punch. However, the semiautomatic DCT 500 processes output to 
the punch or printer (not both) and command statements are provided to specify which 
device is to be used. 


[same [On 


DIRECT OUTPUT TO PAPER TAPE (for the DCT 500 in semi- 


automatic mode) 


DIRECT OUTPUT TO PRINTER (for the DCT 500 in semiautomatic 
mode) 


lf the paper tape punch cannot be accessed due to some hardware problem, the follow- 
ing message will be displayed: 


*PAPER TAPE PUNCH COULD NOT BE SELECTED* 

@ PAPER TAPE INPUT 

Paper tape input is supported for tapes having the format data -CR-LF -data -CR-LF. 

The LF is needed only for readability at the terminal and may be deleted. The follow- 

ing procedure governs the use of paper tape input: 

(1) The paper tape reader should be prepared for input. 

(2) The user must enter the statement, 

@@PTI 
(3) The system will respond with the message: 
*START PAPER TAPE INPUT* 

(4) The paper tape will be read. 

(5) To terminate paper tape input, enter CNTRL-S (X-OFF or DC3) from the keyboard 
or from the tape (the latter is desirable). Multidropped semiautomatic DCT 500s 
will terminate tape input mode when the paper tape is completed. !t is, however, 
desirable to have the CNTRL-S punched into the tape. 

When paper tape input is completed, the symbiont will respond with this message: 


*END PAPER TAPE INPUT* 


(6) Paper tape input will be terminated without operator intervention if a parity error 
is discovered or if data loss occurs. 


(7) If a real-time program prevents the symbiont from properly servicing paper tape 
input and data is lost, the following message will be displayed: 


*PAPER TAPE INPUT DATA LOST* 
The following are special considerations for the utilization of paper tape input: 


(1) A complete run stream may be entered on paper tape. The executive will treat 
this as a batch run. This must be done when the terminal is in inactive mode. 


(2) A @RUN without a @FIN may be entered via paper tape. The run will be treated 
as batch input. Subsequent input from the keyboard will be treated as a continua- 
tion of the batch input. 


(3) Paper tape input may contain nongraphic characters (which are normally illegal) 
if the terminal is in input escape mode. 


@ SPECIAL CHARACTERS 


The TTY/DCT 500 symbiont accepts several ASCII input characters as having special 
meaning. The interpretation of these characters may be changed dynamically by the 
user via the @@TTY and @@DCT symbiont control statements. 
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CNTRL-X Line Delete The current image is 
discarded. The symbi- 
ont responds with a 
CR/LF sequence. 


CNTRL-Z Character Delete | One preceding charact- 
er is deleted each time 
the SUB character is 
sent. 


RETURN or CR End of Image Used to indicate the end 
of an input image. 


The output character > is used to denote input solicitation, i.e., the user may input. 
8 INTERRUPTING OUTPUT PROCESSING 


The break key is represented on the keyboard as BREAK or RTS or INT or INTERRUPT. 
It is used to temporarily terminate output so that the user may enter a demand 
symbiont control statement or a transparent (system) control statement. 


Upon receiving the break/interrupt, the symbiont will print the following message: 
*OUTPUT INTERRUPT * 
@ OPERATION MODIFICATION CONTROL STATEMENTS (@@TTY,@@DCT) 


The TTY/DCT 500 symbiont provides the @@TTY and @@DCT symbiont control state- 
ments which allow the user to change certain parameters associated with his terminal. 
The @@TTY and @@DCT control statements are interchangeable (i.e., may be submit- 
ted from either device) and all parameters on the control statement are optional. 


Format: 


@@TTY char-1, value-1, ..., char-n, value-n 
or 
@@DCT 


The character is a single alpha character selected from: 


Image terminator 
Line delete 
Character delete 
Solicit 

Page width 

Page length 


wsnNOrH 


The value may either be a character (with the exception of page width or page length) 
or an octal or decimal value. If a single digit is used, this is treated as a character. 


DCT 500 IN TELETYPEWRITER MODE 


Once the terminal has established a line connection with the central site, the terminal 
Operator must depress the PROCEED key to establish clear-to-send at the DCT 500. 
The CLEAR TO SEND indicator lights, if the data set is in data mode when the 
PROCEED key is pressed. Once this sequence is performed, the terminal operator can 
send a site-id to the system. 


The site-id must be submitted with upper case alphabetics. The second character of the 
site-id must be a D to signify that the terminal is a DCT 500. 


@ SEMIAUTOMATIC DCT 500 


A brief description of the switches, indicators, and general operation of the device is 
given here to facilitate demand use of the DCT 500. It should be noted that not all 
DCT 500 configurations have all these switches, and thus, not all the capabilities. 
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MASTER/SLAVE Permits the DCT 500 to be the initiating 
station if in MASTER position. To operate 
with the symbiont, this switch must be in the 
SLAVE position. 


XMIT OFF/RECMON This switch is effective only when the DCT 500 
is in full-duplex mode. Since the DCT 500 must 
be in half-duplex mode to operate with the 
symbiont, the setting of this switch has no 
function. 


BAUD RATE This switch is used to set the clock in the DCT 
500 to the same rate as the clock in the com- 
munications terminal at the central site to 
which the DCT 500 is connected. The operator 
must know the rate of the line he is using and 
set this switch accordingly. 


ON LINE/OFF LINE This switch must be set to ON LINE in order 
to make connection with the computer. 


KEYB’D/OFF Since the primary input device is the keyboard, 
this switch must be in the KEY’BD position. 


PRINTER/OFF This switch should be in the PRINTER position 
to allow the printer to be selected. 


READER/OFF This switch should be in the OFF position if 
paper tape is not to be read. !t must be in the 
READER position before paper tape can be 
read. 


PUNCH/OFF This switch should be in the OFF position if 
paper tape is not to be punched. !t must be in 
the PUNCH position before paper tape can be 
punched. 


After the line connection is made, the terminal operator should watch the CLEAR TO 
SEND indicator to know when he has been polled and is able to enter the site-id for his 
terminal. Any letters in the site-id must be entered in upper case by striking the SHIFT 
key along with the letter key. Two time restrictions are placed on the operator in the 
entering of the site-id. He has only a few seconds from the time the CLEAR TO SEND 
indicator lights to enter a character. If this time passes without a character being 
sent, the indicator extinguishes indicating he has been deselected and he must then wait 
to be polled again. After the first character has been struck, he has 15 seconds to enter 
a valid site-id. The terminal is deselected if this time elapses and the operator must 
again wait to be polled again. When the valid site-id is received, the standard initializa- 
tion message is sent to the terminal printer. The terminal is now considered an active 
terminal, and the keyboard is selected so that the user can start his input. 


UNISCOPE 100/DCT 1000 SYMBIONT 
™ OPERATIONAL CONSIDERATIONS FOR THE UNISCOPE 100 


(1) Before the UNISCOPE 100 becomes an active terminal, the operator must turn it 
on and establish the proper line connection. The first message transmitted from an 
inactive device must be the six-character site-id for this device. The site-id may be 
transmitted from anywhere on the screen, preceded by an SOE ([>) character. 


If the message is not received properly, no response is sent to the device. If the 
operator is sure that everything is functioning properly and that the transmitted 
site-id is correct, then the following steps should be taken after a waiting period 
of about 60 seconds: 


(a) Press the wait switch (to unlock the keyboard). 
(b) Transmit the message again. 


The operator sees a positive action when the device is polled to pick up the trans- 
mitted message by the reappearance of the cursor character. The cursor disappears 
from the screen when the transmit key is pressed and reappears when the device is 
polled. 


a 
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(2) Input sent to the computer consists of the data between the cursor and the previous 
SOE or between the cursor and the screen origin, if no SOE precedes the cursor. 
This input is broken into images, each image occupying at most one line of the 
screen. Unless full-screen input has been enabled via the @@FUL statement, 
multiple images will not be accepted. Al! will be rejected if more than one is sent. 


After the operator has pressed the transmit key, the cursor disappears from the 
screen. If the message is received properly by the computer, any output is sent to 
the insert point. The symbiont generates and sends a keyboard unlock message, 
moves the screen up or down (depending on the current setting) one line, and 
positions an SOE character and the cursor in columns one and two of the insert 
line. The operator is free to enter a new line to be transmitted when the SOE 
appears. 


(3) The symbiont controls the screen with output messages. 

The operator may interrupt output via the message waiting key. The computer will 
acknowledge the interruption, and the operator is then free to enter any input, 
specifically including demand symbiont control statements. 

(4) It is the terminal operator’s responsibility to remove his device from the active 
status when he is finished. This is done by transmitting the demand symbiont 
control message @@TERM. If he does not, the terminal will timeout. 

@ OPERATIONAL CONSIDERATIONS FOR THE DCT 1000 


Initialization Procedure: 


(1) Set switches to the following positions: 


AUTO/MAN — AUTO 
MONITOR ON/OFF — ON 

ON LINE/OFF LINE — ONLINE 
KEY B’'D/OFF — KEYB’D 


ALL OTHER DEVICE SWITCHES 


| 
Oo 
as 
Bs 


(2) Establish line connection. 
(3) Press clear key and set RUN/STOP switch to stop position and then run. 
(4) Enter the six-character site-id for this terminal from the keyboard. 


if the transmitted site-id is valid for this particular terminal and is received properly, 
the standard message is printed at the terminal. 


All demand runs submitted via the DCT 1000 must have their @RUN control statements 
entered via keyboard. All @RUN control statements entered via cards or the paper tape 
reader initiate batch runs. 


® OPERATOR SCREEN AND INPUT/OUTPUT CONTROL STATEMENTS 


The following may be requested for the UNISCOPE 100: 


a 


Set screen roll direction to up. There is no response to this message. 


Set screen roll direction to down. There is no response to this mes- 
sage. 


Enable full-screen input (queued mode). In this mode, up to full 
screens of data will be accepted as multiple images. Output will not 
be transmitted, but will be queued and sent when normal input mode 
is reinstated. There are two possible responses: one indicates that 
the request has been accepted, the other that facilities are not avail- 
able at this time for queued mode. 


@@INS xx Set screen insert point at xx, where xx is number of lines on screen. 
If xx is omitted, the original system setting specified in the system's 


generation is used. 


@@PRNT xx 


Start printer on COP number xx. An error message is returned if the 
COP is not configured or cannot be selected. Operands are assigned 
in the system’s generation and are mandatory, as the @@PRNT will 
be ignored without one. Up to six COPs can be configured for each 
UNISCOPE 100. 


@@NOPR Stop printer on COP. 


COP is the UNIVAC Communications Output Printer that is used to obtain a hard copy 
listing of the UNISCOPE 100 screen. 
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Requests valid for either DCT 1000 or UNISCOPE 100 terminats are: 


statement | Deseripion 


@@ESCA Enable escape mode for input. Cursor positions will not be 
stripped from the input data while in escape mode. 


For example, if a terminal operator were to @XQT program, 
and then @@ESCA, the program could determine the cursor 
positions by examining the input data returned via an ER to 
AREADS. 


On output, the user can keep the symbiont from providing 
cursor positioning by placing an ESC (033) as the first 
character of the image which is to be sent to the screen via 
an ER to APRINTS. If he does so, he must then provide any 
cursor control. 


End special mode. Returns terminal from any of the special 
modes (escaped and queued) to normal input mode. 


DCT 1000 Requests 


[| Statement |Description 


@@PRNT Select printer for output. 


@@PTP Enter point-to-point mode. This mode must be configured or 
the command will be ignored. 


@@PTI/@@CDI Select queued mode and enable paper tape or card input. The 
DCT 1000 must be configured with a tape reader or card 
reader. One of two messages may be returned,to the terminal 
indicating that either the request for queued mode was 
rejected or accepted. 


If queued mode is accepted, the operator must: 

OG Clear the KEYBOARD switch. 

0 Set the paper tape reader or card reader switch. 

Q Throw the RUN switch to STOP, then to RUN. 

The input will then begin. An @@END must be submitted 


after the input to allow the queued output to be sent (see 
@@ESCA). 


@@PTO or @@CDO | Enable paper tape or card output. This message type allows 
for computer selection of the appropriate output device. A 
@@PRNT must be entered following all punching to redirect 
output to the printer. 


The operator may override the output device selected by the 
demand symbiont control statement. Unless he chooses to do 
sO, NO switch settings are necessary. 


UNISCOPE 300 SYMBIONT 
® OPERATIONAL CONSIDERATIONS 


(1) Since many UNISCOPE 300s lack @ or + keys, the symbiont translates # and 
&, respectively, into @ and +, if specified in the system’s generation. 


(2) After the operator has dialed the line with which his UNISCOPE 300 is configured, 
he initializes the station with the following procedure: 


(a) Set up message on screen: SOM, (term-id), cursor 


For example: ATSLOO1 (only enough characters (six) to contain the term-id 
will be read — any others will be discarded). 


(b) Press the transmit key. 
(c) Wait for the standard initialization message. 


(d) Submit a @RUN control statement (using normal executive format, except 
that # may be used in place of @). 
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(3) Input images use the format: 

(a) Start-of-message character (A). 

(b) Text (in 64-character images, as many as the screen can hold). 

(c) Cursor. 

For example. ATEXT... 

The input is initiated by the operator pressing the transmit key. This action also 

lights the wait indicator. Acceptance by the symbiont is indicated by the appear- 

ance of the SOM character and the extinguishing of the wait indicator. 
@ SPECIAL CONTROL SEQUENCES 
The message waiting key provides the ability to interrupt output to send input messages 
of control sequences to the central site. Output resumes when the transmit key is 
pressed. The message waiting key may be pressed at any time on a multistation line, 
but on a single station unit it must be pressed just after the output has been received 
and prior to the subsequent acknowledge poll. If the user’s timing is wrong, the mes- 
sage waiting will be ignored, and he should keep trying until the central site acknowl- 


edges his attempt. 


The demand symbiont control statements for the UNISCOPE 300 are the same as those 
for the UNISCOPE 100 with some exceptions discussed briefly below. 


ee 


@@FRZ nn Freeze screen above line nn (two digits must be sent). The por- 
tion of the screen above line nn will no longer be rolled up or 
down. 

@@INS nn Same as UNISCOPE 100, except that two digits must be sent. 

@@HI Use fastest mode output (all scopes initially use this). 


@@MED Use medium rate output (about half speed of @@HI). 


@@LOW Use slow rate output (about one third of fastest). 


@@PRNT xx Assign PAGEWRITER xx. If the PAGEWRITER is already 
assigned to some other scope on the same MSCU unit, a message 
will be sent indicating the assignment was not accomplished. 
The terminal is put into @@LOW rate of output, regardless of 
whether the assignment could be done or not. If aPAGEWRITER 
is in use, and the symbiont cannot communicate with it, an error 
message will be sent. 


@@NOPR Release assigned PAGEWRITER. 


TERMINAL SECURITY SYSTEM 
= LOGGING-ON 


This section applies only if the executive terminal security system is configured into 
the system. Since many different sequences are available, only three primary methods 
are shown. 


The asterisk (*) preceding the user-id takes on a special meaning. If the user-id is so 
configured, the asterisk informs the terminal security system that the user wishes to 
supply his own @RUN statement. If the asterisk is absent, the terminal security system 
will generate the @RUN statement for the user if so configured. 


@ THE BASIC METHOD (AN INSTALLATION OPTION) 


The user must enter a SITEID, a USERID (preceded by an asterisk), and a PASSWORD. 
The SITEID depends upon the terminal which is being used. The USERID and PASS- 
WORD are assigned to the user by the site. In this example, the USERID is JONES 
and the PASSWORD is HAPPY. 
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When Jones logs on the system, the following occurs: 
(1) Jones enters his SITEID: 
SU1801 
(2) The system responds with: 
ENTER USERID/PASSWORD 
(3) Jones must then enter 
* JONES/HAPPY 
followed by a TRANSMIT or carriage return. 
(4) Jones is now logged on. He is now ready to enter a @RUN statement. The system 
will roll the USERID and PASSWORD off the screen for UNISCOPEs or space up 
10 lines and print *DESTROY USERID/PASSWORD ENTRY* for printer 
terminals and, if the USERID is valid, respond with the system header. 


@ THE RUN METHOD (AN INSTALLATION OPTION) 


The run method is similar to the basic method. The run method causes a @RUN image 
to be generated internally. In this example, the USERID is SMITH and the PASSWORD 


is REDDOG. 

Example: 
SU1801 site-id 
ENTER USERID/PASSWORD: 
SMITH/REDDOG 


UNIVAC 1100 OPERATING SYSTEM VERS, xx.xx.xx 
DATE: 061272 TIME: 101242 

RUN NUMBER: 000012 

LAST RUN AT: 061172 093457 


Note that the asterisk is not used in front of the USERID. Note also, that the system 
displays a run number (cumulative for the USERID), the date and time of the last run. 


@ USE OF THE TERMINAL SECURITY SYSTEM PROCESSOR 


The Terminal Security System (TSS) processor is provided to allow a user to influence 
his USERID/PASSWORD environment. 


The TSS processor is invoked by the @TSS executive control statement. One purpose 
of TSS is to give each time-sharing user access to his own security information. This 
capability is dependent upon the individual site configuration and may not be available 
at every site or to every user at a site. 

The TSS processor provides several commands for the user. 


- PWORD COMMAND 


The PWORD command is used to add a password to the list of passwords acceptable 
for the user specified by the USERID given during log-on. The format is: 


PWORD new-password 
The new password must be an alphanumeric of six or less characters. 
- PLIST COMMAND 
PLIST is used to obtain the list of legal passwords for the user. The command format is: 
PLIST 
The output format is: 
PASSWORD: _ password- 1 
PASSWORD: _ password-2 
etc. 
-— ALTER COMMAND 


The ALTER command allows a user to change a password. The format is: 


ALTER old-password, new password 
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— EXIT COMMAND 
EXIT causes the TSS processor to terminate. 
— ERROR MESSAGES 


Several error messages are possible from the TSS processor. 


UIFILE DISABLED - The security file has been destroyed and 
no updates are possible. 
USER UPDATES NOT ALLOWED — The system does not allow the terminal 
user to use TSS. 
COMMAND NOT RECOGNIZED — An invalid command was entered. 
f 
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6. HARDWARE 
CHARACTERISTICS 


ASCIl AND FIELDATA CONVERSION TABLE 


Codes, which also represent collating sequence, are given in octal. 


ASCII codes from 00g to 37g are for communication, format, and separator control 
characters. These are not converted into Fieldata. 


The ASCII symbols represented by codes 40g to 137g are converted into the identical 
Fieldata symbols, except that the quotation marks symbol is converted into a lozenge, 
the circumflex is converted into a delta, and the underscore is converted into a not 
equal sign. . 


There are no remaining unique Fieldata symbols into which to convert the balance of 
the ASCII symbols, represented by codes 140g to 177g, so these codes are ‘’folded’’ 
over codes 100g to 137g (by clearing bit 5, which amounts to subtracting 40g). This 
means that ASCII codes 101g (A) and 141g (a), for example, are both translated as if 
they were code 101g (converted to Fieldata 06g for A). 


Although ASCII is presently a seven-bit code, it may eventually be extended to eight 
bits to allow for additional controls and special graphic characters, including possibly 


whole alternate alphabets. On a 36-bit machine, each ASCII code is stored within a 
9-bit quarter word. 


FIELDATA TO ASCII CONVERSION 


FIELDATA ASCII FIELDATA ASCII 
OCTAL OCTAL OCTAL OCTAL 
CODE SYMBOL CODE SYMBOL CODE SYMBOL CODE SYMBOL 


00 40 


-S— tAHOVIA+ IT ~— 
S~ tAMOVNiA+ 1] ~ 


— NS 
ome ree 


SOMONOOBRWN HO. 


N<XS<CHNDOVOZErAcC-TOmMIAD?PY, d#-——O 
SOWONOOAHPWNH—O -~-~ 


# 
A 
SP 
A 
B 
Cc 
D 
E 
F 
G 
H 
| 
J 
K 
L 
M 
N 
O 
Pp 
Qa 
R 
S 
r 
U 
V 
W 
Xx 
Y 
Z 


0 a RL NE AA TERT EET APIS ES LETS ESI EE EE I ETE SIE EE DEE IT 


UP—7824 PAGE 6-1 
Rev. 1 UPDATE 


EXEC 8 PAGE 6-2 
Hw/Sw Sum UPDATE 


FIELDATA OCTAL CODE TO CARD PUNCH CONVERSION 


OCTAL CODE|SYMBOL| CARD CODE] OCTAL CODE} SYMBOL 
00 40 


CARD CODE 


BS—~ *AHAMOVIAtFt 1 ~— 


om ones 


N<xS< CHYNDOVOZESrFAC-TONMIIOWPSCPDH-—O 
OMNOOIRWN-O-- 


ASCII TO FIELDATA CONVERSION 


ASCII FIELDATA ASCII FIELDATA 
OCTAL OCTAL OCTAL OCTAL 
CODE CODE cope (SYMBOL! Cope |SYMBOL 


40 05 13 


~~ SRB PMAt 
+ eH -PReaeta-¥Y 


+ 


. 


OOnNONPWNH—O~.: 


ODIMAMAWNY-O~. 
- | >—--n«<xe<c40n0v0OzErne-ron 


@tP—-—“N<KXSB<CHAMNDOVOZZSrAc—-ION 


? ; * A ee 
< < through 
= = Z 
> > ? 
? ? » 
@ @ { 
A A A 
B B # 
Cc Cc 
D D *lowercase alphabet 
E E **uppercase alphabet 
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THE SPECIAL CHARACTERS IN ASCII 


SP _—_ designates space, which is normally nonprinting. 

DEL designates delete, and has a code of all 1 bits. 
This code obliterates any unwanted previous character — even on paper tape 
or other nonerasable medium. 


The names of the 8 Some additional standardized names 
new special characters of interest: 
in ASCII are: 
“Quotation marks # Number sign 
“~ Circumflex & Ampersand 
— Underline ’  Apostrophe 
‘Grave accent * — Asterisk 
{ Opening brace > Greater than sign 
1 Vertical line @ Atsign 
} Closing brace [ Opening bracket 
~ Tilde \ Reverse slant 


Definitions of the 32 ASCII control characters, codes 00g to 37g: 


00 NUL Null — all zeros character which may serve as time fill 
01 SOH Start of heading 

02 STX Start of text 

03 ETX End of text 

04 EOT End of transmission 

05 ENO Enquiry — ‘‘Who Are You?” 

06 ACK Acknowledge — ‘Yes’ 

07. =BEL Bell — human attention required 

10 BS Backspace 


11. HT Horizontal tabulation 
12 LF Line feed format effectors for printing 
13. VT Vertical tabulation or punching 


14. FF Form feed 

15 CR Carriage return 

16 SO Shift out — nonstandard code follows 

17 ~Si Shift in — return to standard code 

20 DLE Data link escape — change limited data communication controls 


22 DC2 , : ‘ F 
23 «~DC3 Device controls for turning on or off ancillary devices 
24 DC4 


25 NAK _ Negative acknowledge — ‘‘No”’ 

26 SYN Synchronous idle — from which to achieve synchronism 

27 ~=ETB End of transmission block — relates to physical communication blocks 
30 CAN Cancel previous data 


31 EM End of medium — end of used, or wanted portion of information 

32 SUB Substitute character for one in error 

33 ESC Escape — for code extension — change some character interpretations 
34 FS File separator These information separators are ordered in de- 
35 GS Group separator scending hierarchy. They are followed by ASCII 
36 RS Record separator 40g (space), which can also be thought of as a 
37. US Unit separator word separator. 


SERRE AE DISET EE I A I IE IE PE EIST 
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INSTRUCTION REPERTOIRE 
Code (Octal) Mnemonic Instruction Description 
Hi iQee fe ie 


Store A (A) >U 
Store Negative A —(A)7U 
Store Magnitude A (A)| >U 
Store R (R,) 7U 
Store Zero ZEROS ~ U 


Store X (X,) 7U 


Load D-Bank Base BDW — active PSR,SLR 

and Jump (D-bank value); BDI regis- 
ter D-bank value > 
Xa35_1g; new BDI 
values > BDI register; 
relative P+1 > Xa17_0: 
jump to U 


Load !-Bank Base BOW ~ active PSR, SLR 

and Jump (!-bank values); BDI regis- 
ter |-bank values > 
Xa35—1g; new BDI values 
BDI register; relative 
P+1 — Xaz7_Q9; jump to U 


LOAD BANK AND JUMP 


*1110 only 
+1110 instruction simulated on 1106/1108 
= Restricted use (illegal code or privileged use by the executive) 
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Function 
Code (Octal) 


Load PSR 
Designators 


Description @ 


Ug5,3-0 > PSRM; 
Bit6 >D20 Bit 2~D8 
Bit5->D17 Bit1~D5 
Bit3—D10 BitO ~D4 


Store PSR 
Designators 


PSRM D-bits >Ug_o; 

D20—>Bit6 D8 Bit 2 
D17—>Bit5 D5—>Bit 1 
D1i2—>Bit4 D4—>Bit0 
D1i0 > Bit 3 


PSR DESIGNATORS 


Load A (U)-A 


L,LA 


LN,LNA —(U) >A 


Load Negative A 


LM,LMA Load Magnitude A (UJ[ >A 


LNM,LNMA | Load Negative —|(U)| 7A 


Magnitude A 


Add ToA (A)+(U) 7A 


(A)-(U) 7A 


Add Negative to A 


Add Magnitude To AJ (A)+|(U)| >A 


(A)—(U)| 7A 


Magnitude toA 


Add Upper (A)+(U) >A+1 


Add Negative Upper | (A)—(U) >A+1 


ANU 
22 0-15 —| BT Block Transfer (X,+u) > X,+u; repeat(R1 
times 


A,AX Add To X (X,)+(U) >X, 
AN,ANX 


LXM 
Mi 
MSI 
MF ; 
BM 


BMT 


Add Negative To X | (X,)—(U) >X, 


X 


Load X Modifier (U) Xa, 7-0' 


unchanged 


435-18 


Load X (U) >X, 


Multiply Integer (A) *(U) ~A,A+1 


Multiply Single (A)*(U) >A 


Integer 


(A) *(U) ~A,A+1, left shift 
circular 1 bit 


Multiply Fractional 


(SJO) >SJ1 


Byte move 


Byte Move and Translated (SJO) > SJ1 


Translate 


Translate (SJOQ); test 


Byte Translate and 
against (A); terminate if # 


Test 


Translated (SJO) — trans- 
lated (SJ1) >A; terminate 
if (A) #0 


Byte Translate and 
Compare 


(SJO) — (SJ1) >A; 
terminate if (A) #0 


Byte Compare 


11110 instruction simulated on 1106/1108 
*1110 only 


= Restricted use (illegal code or privileged use by the executive) 


CL ES SR I YS TE RSS ESE TE IE PE TE a 
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Hw/Sw Sum UPDATE 
Code (Octal) 
Description) 
Byte to Packed Convert (SJO) — packed 
Decimal Convert decimal SJ1 


Packed Decimal to 
Byte Convert 


Convert packed decimal 
(SJO) >SJ1 


Edit 


Edit (SJO) under control 
of (SJ2) >SJ1 


Convert (SJO) > signed 
binary integer A 


Byte to Binary 
Single Integer 
Convert 


Binary Double 
Integer to Byte 
Convert 


Convert signed binary 
integer (A,A+1) >SJO 


2 

e) Byte to Binary Convert (SJO) > signed 
pe Double I! nteger binary integer A,A+1 
= Convert 

z 

> Binary Single Convert signed binary 
ome Integer to Byte integer (A) > SJO 

= Convert 

wi 

= 

> 

co 


Byte to Single 
Floating-Point 
Convert 


Convert (SJO) > single- 
precision floating-point 
format A 


Convert (SJO) > double 
precision floating-point 
format A,At+1 


Byte to Double 
Floating-Point 
Convert 


Single Floating- 
Point to Byte 
Convert 


Convert single-precision 
floating-point format 
(A) >SJO 


Double Floating- 
Point to Byte 
Convert 


Convert double-precision 
floating-point format 
(A,A+1) ~SJO 


(A,A+1) = (U) >A; 
REMAINDER A+1 


Divide Integer 


Divide Single 


((A,36 sign bits) right 
Fractional ~ 


algebraic shift 1 place] = 
(U) >A+1 


Divide Fractional {(A,A+1) right algebraic shift 
1 place] ~(U) >A; 


REMAINDER ~A+1 


Quarter-Word Byte 
to Binary Compress 


Discard (A)35, (A)ag, (A) 17, 
and (A)g; remaining bits 
(A) *A31_0:(A)31 7A35-32 


Binary to Quarter- 
Word Byte Extend 


Discard (A)35-32; (A)31_90 > 
A34-27, A25-18. A16~9, 
and A7_9; zero fill Ags, 

A26, Ay 7: and Ag 


Quarter Word Byte 
to Binary Halves 
Compress 


Discard (A)35, (A) 26, (A)17, 
and (A)g; remaining bits 

(A) ~A33-18 and 45-0; 
(A)33 >A35~-34, (Ali5 > 
A17~-16 


BYTE MANIPULATION 


Binary Halves to 
Quarter-Word Byte 
Extend 


Discard (A)35-34 and 
(A)17—16: remaining bits 
(A) >A34-27, A25—18, 
Aig—g, and A7_9; zero-fill 
A35, A2.~, Ay 7. and Ag 


*1110 only 
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Function ; 
Code (Octal) 


Quarter-Word 
Byte to Double 
Binary Compress 


Description”) 


Discard A35, A26, A17, Ag, 
At+135, At12g, A+117, and 
A+1g; remaining bits 

(A,A+1) >A27-0 and 
A+1; (A)o7 >A35-28 


Double Binary to 
Quarter-Word Byte 
Extend 


Discard (A)35~—28: remaining 
bits (A,A+1) > A34-27, 
A25—18, A1g—9, A7-0, 
A+134~27, Atl25~18, 
A+11g~9, and A+17_ 9; zero- 
fill Ags, Azg, A17, Ag, 
At+135, A+126, A+117, and 
Atig 


BYTE MANIPULATION 


Byte Add (SJ1) + (SJO) >SJ2 


Byte Add Negative | (SJ1) — (SJO) >SJ2 


Logical OR (A) GER (U)>A+1 


Logical Exclusive (A) (U)>-A+1 


OR 


(A) (U)PA+1 


Masked Load Upper| [(U) (R2)) ta 
[(A) (R2)']>A+1 


Skip NI if (U) (A) 
has even parity 


Skip NI if (U) (A) 
has odd parity 


x 46 0-17 — {LXI Load X Increment CON Rages gpa 5G 
unchanged 


Test Less Than or | Skip Nf if (U) <(X,) 
Equal To Modifier 17-0 


Logical AND 


LOGICAL 


Test Even Parity 


TEST 


Test Odd Parity 


17-0" 


always (Xa), 4 + (X,) 
Test Not Greater >X, 
Than Modifier 17-0 


35-18 


Test Zero Skip NI if (U) = +0 


Test Nonzero Skip NI if (U) #+0 
Test Equal Skip NI if (U) = (A) 
Test Not Equal Skip NI if (U) (A) 
Test Less Than or | Skip NI if (U) <(A) 


Equal 
Test Not Greater 


TEST 


Test Greater Skip NI if (U) >(A) 
Test Within Range | Skip NI if (A) <(U) <(A+1) 


Test Not Within Skip NI if (U) <(A) 
Range or (U) >(A+1) 


Test Positive Skip NI if (U)35 =0 
(requires full 

word or sign 

extension) 


Test Negative Skip NI if (U)35 = 1 
(requires full word 
or sign extension) 


*1110 only 
= Restricted use (illegal code or privileged use by the executive) 
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Code aa 
Description 
iF 


Skip NI if (U) =(A 
else repeat 


Search Equal 


Skip NI if (U) #(A), 
else repeat 


Search Not Equal 


Search Less Than 
or Equal 
Search Not Greater 


Skip NI if (U) <(A), 
else repeat 


SEARCH 


Skip NI if (U) > (A), 
else repeat 


Search Greater 


Search Within 
Range 


Skip NI if (A) <(U) S(A+1), 
else repeat 


Search Not Within 
Range 


Skip NI if (U) <(A) or 
(U) >(A+1), else repeat 


Jump Greater and 
Decrement 


Jump to U if (Control 
Register);, >0; go to NI if 
(Control Register)), <0; 

always (Control Register);, —1 > 
Control Register j, 


Mask Search Equal | Skip NI if (U) (R2)=(A) 


(R2), else repeat 


Mask Search Not 
Equal 


Skip NI if (U) (R2) #(A) 
(R2), else repeat 


Mask Search Less 
Than or Equal 

Mask Search Not 
Greater 


Skip NI if (U) (R2) <(A) 
(R2), else repeat 


Mask Search 
Greater 


Skip NI if (U) (R2) >(A) 
(R2), else repeat 


Masked Search 
Within Range 


Skip NI if (A) (R2) <(U) 
(R2) S(A+1) (R2), 


else repeat 


MASKED SEARCH 


Masked Search 
Not Within Range 


Skip NI if (U) (R2) <(A) 
(R2) or (U) (R2) > 
(A+1) (R2), else repeat 


Masked Alpha- 
numeric Search 
Less Than or Equal 


Skip Nt if (U) (R2) <(A) 
(R2), else repeat 


Masked Alpha- 
numeric Search 
Greater 


Skip NI if (U) (R2) >(A) 
(R2), else repeat 


Double Precision 
Fixed-Point Add 


(A,A+1)+(U,U+1) >A,A+1 


Double Precision 
Fixed-Point Add 
Negative 


(A,A+1)—(U,U+1) >A A+1 
Double Store A (A,A+1) >U,U+1 
Double Load A (U,U+1) >A,A+1 


Double Load 
Negative A 


—(U,U+1) ~A,A+1 


DOUBLE PRECISION 


Double Load 
Magnitude A 


\(U,U+1)| >A,A+1 


Double Precision 
Jump Zero 


Jump to U if (A,A+1)= +0 
go to NI if (A,A+1) # +0 


Double Precision 
Test Equal 


Skip NI if (U,U+1)=(A,A+1) 


UP—7824 
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Function 
Code (Octal) 


Description) 


7201 —J|SLJ Store Location (P)—-BASE ADDRESS 
and Jump MODIFIER [BI or BD] ~U,7_0; 
jump to U+1 
= 7202 — 4 JPS Jump Positive and {Jump to U if (A)35=0; go to NI 
= Shift lif (A)35=1; always shift (A) 
ae left circularly one bit position. 
7203. — | JNS Jump Negative and | Jump to U if (A)35=1; go to NI 


Shift if (A)35=0; always shift (A) 


left circularly one bit position 


AH Add Halves (A)35—18+(U)35_ 18 >A35~-18: 
a (A)17—0t(U)17-0 7A17~-0 
a) 
4 ANH Add Negative (A)35—18—(U)35_ 18 7A35_18; 
e Halves (A)17-0-(U) 17-0 7 A17~-0 
oO 
= AT Add Thirds (A)35— 24t(U)35_ 24 >A35~— 24; 
z Hea ancy Ota 12: 
= (A) 44—0+(U)44- 09 7A 
oc . 
< ANT Add Negative (A)35—24—(U)35-24 7A35—24; 


Thirds (A)o3~-342—(U)23- Rs 12; 


(A)44-o0-(U)44— ere 


72 11 Executive Request See executive request 
interrupt to address 242g 


72 14 0-3 | SCN Store Channel If a=0: CHANNEL NUMBER 
Number U3 _ 9; 

If a=1: CHANNEL NUMBER 

U3_9 and CPU NUMBER 


5-4 

If a=2: CHANNEL NUMBER 
Us5_ 9; 

If a=3: CHANNEL NUMBER 
—Us_9 and CAU NUMBER 
7U 14-12 


only 
= Restricted use (illegal code or privileged use by the executive) ; 
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Function 
Code (Octal) 


Single Shift 
| Circular 


Shift (A) right circularly U 
places 


Double Shift 
Circular 


Shift (A,A+1) right circu- 
larly U places 


Single Shift 
Logical 


Shift (A) right U places; 
zero-fill 


Double Shift 
Logical 


Shift {A,A+1) right U 
places; zero-fill 


Single Shift 
Algebraic 


Shift (A) right U places; 
sign-fill 


Double Shift 
Algebraic 


Shift (A,A+1) right U 
places; sign-fill 


Load Shift and 
Count 


(U) >A, shift (A) left cir- 
cularly until (A)35 FA(A)3q 
number of shifts > A+1 


Double Load Shift 
and Count 


(U,U+1) >A,A+1; shift 
(A,A+1) left circularly unti 
(A,A+1)74 #(A,A+1)79; 

number of shifts >A+2 


Left Single Shift 
Circular 


Shift (A) left circularly U 
places 


Left Double Shift 
Circular 


Shift (A,A+1) teft cir- 
cularly U places 


Left Single Shift 
Logical 


Shift (A) left U places 
Zero-fill 


Left Double Shift 
Logical 


Shift (A,A+1) left U places; 
zero-fill 


"1110 only. 
= Restricted use (illegal code or privileged use by the executive) 


UP—7824 
Rev. 1 


EXEC 8 
Hw/Sw Sum 


Code (Octal) sAncinonie 


TEST AND SET 


*1110 only. 


Test and Set 


Test and Set and 
Skip 


Test and Clear and 
Skip 


Jump Zero 


Jump Nonzero 


Jump Positive 


Jump Negative 


Jump Keys 
Jump 


Halt Keys and Jump 


Halt Jump 


No Operation 


Allow All 1/0 


Interrupts and Jump 


Jump No Low Bit 


Jump Low Bit 


Jump Modifier 
Greater and 
Increment 


Load Modifier and 
Jump 


Jump Overflow 


Jump Floating 
Underflow 


Jump Floating 
Overflow 


: (Xalgg_ 


Description @ 


If (U)39=1, interrupt to 
MSR+244g; if (U)39=0, go 
to NI; always 01g ~U35_9 


If (U)39=0, skip NI; if 
(U)39=1, go to NI; always 
01g >U35-30 


If (U)39=0, go to NI; if 
(U)39=1, skip NI; always 
clear (U)35~39 


Jump to U if (A)=+0; go to 
NI if (A)#+40 


Jump to U if (A) #+0; go to 
NI if (A)=+0 


Jump to U if (A)35=0; go to 
NI if {(A)35=1 


Jump to U if (A)35=1; go to 
NI if (A)35=0 


Jump to U if a=0 or if a 
set SELECT JUMPS con- 
trol circuit; go to NI if 
neither is true 


Stop if a=0 or if [a set 
SELECT JUMPS control 
circuit] #0; on restart or 
continuation, jump to U 


Proceed to next instruction; 
if the x and h fields of the 
instruction operand are non- 
zero, index register 
incrementation occurs 


All all t/O interrupts and 
jump to U 


Jump to U if (A)g=0; go to 
NI if (A)o=1 


Jump to U if (A)g=1; go to 
NI if (A)g=0 


Jump to U if (X,) 

go to NI if (Xa),7_5 
always (Xa),7_5 + 

18 > Xa17-0 
(P)-BASE ADDRESS 


MODIFIER [BI or BD] > 
Xa47~9' jump to U 


Jump to U if D1 of PSR=1; 
go toN! if D1=0 


Jump to U if D21=1, clear 
D21; go to NI if D21=0 


Jump to U if D22=1, clear 
D22; go to NI if D22=0 


= Restricted use (illegal code or privileged use by the executive) 
SPT TS GPE SD I 7 ST gS SE I Pa TE SS I 
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Code aes Deseription @) 


Jump Divide Fault Jump to U if D23=1, clear 
D23; go to N! if D23=0 


Jump to U if D1=0; go to 
Nl if D1=1 


Jump No Overflow 


Jump to U if 021=0; go to 
NI if 021=1; clear D21 


Jump No Floating 
Underflow 


Jump to U if 022=0; go to 
NI if D22=1; clear D22 


Jump No Floating 
Overflow 


Jump No Divide 
Fault 


Jump to U if 023=0; go to 
NI if D23=1; clear D23 


Jump to U if DO of PSR=1; 
go to NI if DO=0 


Jump Carry 


Jump to U if DO of PSR=0; 
go to NI if DO=1 


Jump No Carry 


*1110 only. 
E=J= Restricted use (illegal code or privileged use by the executive) 
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Code (Octal) Mnemonic Description @) 


FLOATING POINT 


FA Floating Add (A)+(U) >A; RESIDUE > 


A+1 (if D17=1*) 


FAN Floating Add 
Negative 


(A)—(U) >A; RESIDUE > 
A+1 (if D17=1") 


FM Floating Multiply (A) *(U) @A,A+1 (if 


D17=1") 


(A) =(U) >A; REMAIN- 
DER >A+1 (if D17=1") 


FD Floating Divide 


LUF Load and Unpack (U)|34-27 7A7~0. 
Floating zero-fill; (UJog_o 
A+1 6-0; sign-fill 
LCF Load and Convert (U)35 > At+135; [NOR- 
To Floating MALIZED (U)] 2g-9 > 


A+1 26-0; if (U)35=0, 
(A)7-9+ NORMALIZING 
COUNT > A+134~-27: if 
(U)35=1, ones complement 
of [(A)7_- 9+ NORMALIZ- 
ING COUNT] ~At+134_27 


IA) lg5-27—-(U) I35_ 271 
>Atig_o; ZEROS > 
At+135-9 


MCDU Magnitude of 
Characteristic 
Difference To 
Upper 


CDU Characteristic (A) l35—27—l(U) I35_27 
Difference >At+1g_9; SIGN BITS > 
To Upper At+135-9 


*1110 only 
EZZ.= Restricted use (illegal code or privileged use by the executive) 
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Mnemonic Instruction Description) 


Double Precision (A,A+1)+(U,U+1) ~A,A+1 
Floating Add 


Double Precision (A,A+1)—(U,U+1) >A,A+1 
Floating Add 
Negative 


Double Precision (A,A+1) (U,U+1) > 
Floating Multiply A,A+1 


Double Precision (A,A+1)HU,U+1) ~A,A+1 
Floating Divide 


Double Load and I(Ulg4_24 *A10-0. 

Unpack Floating zero-fill; (U)a3_9 > 
A+193_ 0, sign-fill; 
(U+1) ~A+2 


Double Load and (U)35 ~Atigs5; [NOR- 

Convert To Floating | MALIZED (U,U+1)] 59-0 
+ A+193~09 and At2; if 
(U)35=0,(A)10-0 
NORMALIZING COUNT 
> A+134~24; if (U)35=1, 
ones complement of 
[(A)19~0 t NORMALIZ- 
ING COUNT] ~At+134-24 


- 
= 
©) 
a 
O 
< 
| and 
< 
oO 
4 
cs 


Floating Expand If (U)35=0, (U)35_27+ 

and Load 1600g > A35_24: if 
(U)35=1, (U)35-27- 
16003 > A35~ 24; 
(U)ag-3 *A23-0; 
(U)2_9 ~At+135~33; 
(U)35 7 A+132-0 


Floating Compress If (U)35=0, (U)35-24- 

and Load 1600, ~>A35-27: if 
(U)35=1, (Ulg5—24+ 
16003 > A35-27: 
(U)23-9 ~A26-3: 
(U+1)35-33 ~A2-0 


= Restricted use (illegal code or privileged use by the executive) 


NOTES: 
Q) NI stands for Next Instruction. 


The a and j fields together serve to specify any of the 128 control registers, 
meaning any register from the full X, A or R set. 


@ If only one specific bit of (U) is set to 1, TOP skips if the corresponding bit 
of (A) is also set to 1, regardless of what other bits of (A) are set. 


G) If only one specific bit of (U) is set to 1, TEP will skip if the corresponding bit 
of (A) is zero, regardless of what other bits of (A) are set. 


6) j=0g, 3g—7g, 17g are the only meaningful j designator values because of the sign 
extension requirements. j=4g—7g, is not meaningful for quarter-word mode. 


6) If guard mode is set, causes guard mode interrupt to address 243g. If guard 
mode is not set, same as NOP. 
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MNEMONIC/FUNCTION CODE CROSS-REFERENCE 
[Function Code (Octal _| | Funetion Code (tal 
i ae ae ae es 
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OCTAL VS. MNEMONIC INSTRUCTION CODES 


FIRST FUNCTION CODE — SECOND DIGIT 


DIGIT 
Pea ee a ee 7! 
S,SA | SN SM SZ S,SX 1/0 
SNA SMA (see below) 
L LN LM LNMA! A AN AM ANM 
LA LNA | LMA AA ANA AMA ANMA 
AU ANU | BT L,LR A AN LXM L 
AX ANX LX 


3 MF DSF DF Bytes 
(see below) 
XOR | AND MLU TOP TLEM 
TNGM 
TNZ TLE 
TNG 
™ SLE SG 
SNG 


SEE BELOW 


ae SECOND j DIGIT 
FUNCT. 
i 
SIA | SOA SIP SOP LIA LOA LIP 
LCB | LPI LDJ LiJ LPD | SPD LBR, 
SJS 
BM BMT | BTT* | BTC | BC BPD* oe ad 
BI BD! IB DIB BF BDF ad 
SLR rl 
MSLE 
MSE | MSNE} MSNG; MSG | MSW }| MSNW] MASL |] MASG 
DA DAN | DS DL DLN | DLM DJZ = 
rac SLJ JPS JNS | AH Soe 
ER PAIS | SCN 
bie DSC SSL DSL = DSA a a 
LSSC;} LDSC | LSSL |} LDSL SIL LCR, 
LLA 
JNZ JP JN Mo ie a 
ne JB JMGI | LMJ a 


LIC | LICM | JIC LOC | LOCM; JOC DOC 
LFC | LFCM| JFC AACI! PACI | ACI PCI 


FA |FAN | FM FD LUF | LCF MCDU | CDU 
DFA ; DFAN| DFM | DFD | DFU | DFP FEL FCL 


*Used only by assembler. 


LPS, LMP, LUP 

LSL, LUS, SL, SUL 

lit, EDC, DDC, CES, ES 
TS, TSS, TCS 

JO, JFU, JFO, JDF 

JNO, JNFU, JNFO, JNDF 


OnhWNh — 


ST AS ISTE AAG A PRE RI PS BP EE OSES PE TS SE FE SSS TI IIE ILE IE ED LED 
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MNEMONIC DESIGNATION AND ABSOLUTE ADDRESSES 
OF CONTROL REGISTERS AND PARTIAL WORD 
DESIGNATORS 


The proc call AXR$ must appear in operand field prior to any references in the code to 
these mnemonics. 


STAGING 
INDEX ARITHMETIC REGISTERS PARTIAL WORD 
REGISTERS REGISTERS REGISTERS J REGISTERS DESIGNATION 
ABSO- ABSO- ABSO- ABSO- A8SO- 
LUTE LUTE LUTE LUTE LUTE 
{(OCTAL) (OCTAL) (OCTAL) (OCTAL) 


CONTROL REGISTER ADDRESS ASSIGNMENTS 


INTEGRATED CIRCUIT REGISTERS (ICR) UNIVAC 1106/1108 


OCTAL DECIMAL 


TEMPORARY STORAGE FOR 
PSR AT INTERRUPT 


15 INDEX REGISTERS (X) 


4 REGISTER OVERLAP 


16 ACCUMULATORS (A) 


4 UNASSIGNED 


SP RP GT a I I I ET DP I I ET TE ETO 
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101 REPEAT COUNT REGISTER (R1) 


MASK REGISTER (R2) 16 R REGISTERS 


a, aS PARTY 


=g= For use only by the executive (guard mode protected) 


B® The UNIVAC 1110 GRS is equivalent to the ICRs in the 1106/1108 with the 
following exceptions: 


(1) The I/O buffer ACWs (addresses 41-77) are moved to the IOAU. 


(2) The values in 40—57 are new. 


(3) The Staging-registers and. J-registers are also new (addresses 103~—111 and 
123—131) and are used for character and byte instruction. 


ee SS a a EL ET TT 
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GENERAL REGISTER STACK (GRS) 


UNIVAC 1110 
OCTAL DECIMAL FUNCTION 


ie NON-INDEXING X REGISTER XO a 
spe [ef epee 
XO — 
14 12 T OVERLAPPED (X OR A) 
[a ee | Se eas 
20 12 ; 16 ACCUMULATORS (A) 
Ad — AIS A 
34 A15+1,A15+2 
ALES 3.5 ees UNASSIGN. seC UNASSIGNED 


io REPEAT COUNT REGISTER 
gal Mase ReceTen eo > oe 


103 STAGING REGISTERS SR1—SR3 | 67 

R3—R5 69 | 16 SPECIAL REGISTERS (R) 
06 J—REGISTERS JO —J3 70 

R6 — R9 73 


+——— 36 BIT + PARITY + 


FZZZJ = For use only by the executive (guard mode protected) 
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J-DETERMINED PARTIAL WORD TRANSFERS 


Note that when a contro! register is specified in the u field of an instruction, j designators 


from 1g to 15g are treated the same as a j designator of Og. That is, a whole word 
register-to-register transfer occurs. 


Quarter 
j-Value Word 
(Octal) Designator 


Main Storage 
Mnemonic 


for j Control Register 


1 
2 
SIGN EXT. 11 


UP—7824 
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Quarter 
j-Value Word Mnemonic 
(Octal) Designator for j 
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Main aa 


Control Register 


SIGN EXT, 
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Quarter Control Register 
j-Value Word Mnemonic 
(Octal) Designator for j Main Storage 


aaa Foe 
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Quarter Control Register 
j-Value Word Mnemonic 1 
(Octal) Designator for j Main Storage 


NO TRANSFER 


aaa 


PROCESSOR STATE REGISTER (PSR) FORMAT 


INSTRUCTION BANK 
BASE REGISTER 


B\/Bp SELECTION 
eee ce 


DO Bit 27 Arithmetic Carry Designator 

Dis Bit 28 Arithmetic Overflow Designator 

D2 Bit 29 Guard Mode 

D3 Bit 30 Write Only Storage Protection 

D4 Bit 31 (1106/1108) 1107 Compatibility; (1110) Character Addressing Mode 


a 
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D5 Bit 32 Double Precision Underflow 

D6 Bit 33 Control Register Selection 

D7 Bit 34 Base Register Suppression if i = 1 

D8 Bit 35 Floating-Point Zero 

D9 Bit 16 (1106/1108) Not Used; (1110) Index Register Mode 24 Bit if D7=1 
and i=1 

D10 Bit 17 Quarter Word Mode 


PROCESSOR STATE REGISTER EXTENDED™(PSRE) FORMAT 


D/ DID D D}| D}D 
UNUSED 2322 |21/20 17 13}12 171 BIX BDX 
12|11 615 0 


D11 Bit 12 Operand Base Selector PSRU if = 1 
D12 Bit 13 PSR/SLR Selector: Utility if = 1 

D13 Bit 14 PSRM | Bank Write Inhibit 

D14 Bit 15 PSRM D Bank Write tnhibit 

D15 Bit 16 PSRU | Bank Write Inhibit 

D16 Bit 17 PSRU D Bank Write Inhibit 

D17 Bit 18 Residue Store Single Precision FP 
D18 Bit 19 PSR/SLR Auto Switch Enable 

D19 Bit 20 Allow EXEC Bank Descriptor Pointer 
D20 Bit 21 Arithmetic Exception Interrupt Designator 
D21 Bit 22 Characteristic Underflow Designator 
D22 Bit 23 Characteristic Overflow Designator 
D23 Bit 24 Divide Fault Designator 

*1110 Only 


OTHER WORD FORMATS 


INSTRUCTION WORD 


Note that the final operand address generated (specified as bit U), in both direct and 
indirect addressing, is based on the four fields x, h, i and u. 


INDEX REGISTER WORD (Control Registers X1—X11 and AO—A3) 


Xj 
Increment Portion 


ISI (Internally Specified Index) ACCESS CONTROL WORD 


W 
Number of words left Vv 


to transfer Current address 


The values of G are 0 — increment, 102 — decrement, 1 or 11 — neither 


*1110 only. 
SR RP ERT GAG ES ES SS SS IE II SDC ESOT 
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IS1 (internally Specified Index) CHAIN POINTER WORD * 


Relative Address of 


BASE FIELD Next ACW Pair 


21/20 1918 |17 


BASE FIELD The BASE FIELD is added as bits 23—9 to the ACW specified address 
to form a 24 bit absolute address. 


NU Not used. 


Cc Chain bit: if set to one, use address in H2 relative to the chain base 
register to get the next ACW and CPW. 


ESI (Externally Specified index) ACCESS CONTROL WORD (H is one bit on halfword, 
two bits on quarterword; C is present for quarterword) 


| W Vv 
G |H Hi Cc | Character Count Initial address 


35 34)33/32131 30129 


The settings of H toggle back and forth to indicate H2, H1 (or 04, Q3, Q2, Q1) in 
successive sequence. 


1ACW (Input Access Control Word) ACTIVE POINTER * 


ABSOLUTE ADDRESS OF 
TABLE LENGTH ESL INT TABLE 


33 


BIASED ESI VALUES IN IACRs (Input Access Control Registers, 40g—57g) — 1106/ 
1108 


BIASED INPUT ESI VALUE BIASED OUTPUT ESI VALUE 


HALF-WORD ESI CHAIN POINTER WORD * 


RELATIVE ADDRESS OF 
BASE FIELD NEXT ACW PAIR 


Et CHAIN = When set specifies data chaining when an ESI external interrupt 
occurs. 


ESI ACTIVE POINTER * 


RELATIVE ADDRESS 
WORD COUNT OF NEXT TABLE ENTRY 


ES! AUXILIARY POINTER* 


RELATIVE ADDRESS 


WORD COUNT OF NEXT TABLE ENTRY 


*1110 only. 
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SINGLE-PRECISION FIXED-POINT WORD (See Fixed-Point Arithmetic Instructions) 
AorU 


S 


Oo 


35 134 


‘S’ is the sign bit. 


DOUBLE-PRECISION FIXED-POINT WORD (See Instruction Functions 71 10—11) 
Aor U 


S 

354 34 0 
At+1 or U+1 

35 0 


FIXED-POINT MULTIPLY INTEGER (Ml) RESULT (See Instruction Functions 30 


0-17) 

A 

S| S$ 

35 | 3433 0 
At+1 

35 0 


FIXED-POINT MULTIPLY SINGLE INTEGER (MSI) RESULT (See Instruction Func- 
tions 31 0—17) 
A 

S 


35 | 34 0 


Note that the 35 high order (most significant) bits of this resuit are not retained. 


FIXED-POINT MULTIPLY FRACTIONAL (MF) RESULT (See Instruction Functions 


32 0-17) 
A 
S 
35 | 34 0 
At+1 

S 
35 1\0 


As opposed to the Multiply Integer, above, the Multiply Fractional does a final Left 
Double Shift Circular of the most high order sign bit, from bit position 35 in A to bit 
position 0 in A+1. 


OS PERE ISEB ES aA RE TALEO ME POI ITY SIE ILE EAS IE TEE SOO OLLIE ARLES TEL SEE TEI TE SLT SELES BEN IE ITE AINSLIE TE NEI NESE SLE IEE LIE LEN EO 
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ADD HALVES (AH) WORD FORMAT (See Instruction Functions 72 4—5) 


L__. Carry Larry aa ee 
SINGLE-PRECISION FLOATING-POINT OPERAND (See Instruction Functions 76 
0—7, 16-17) 


CHARACTER- 
ISTIC (BIASED 


EXPONENT) 


27 


SINGLE-PRECISION FLOATING-POINT RESULT (See Instruction Functions 76 
0-7, 16—17) 
A 


CHARACTER- 
ISTIC (BIASED 
EXPONENT) MANTISSA (NORMALIZED) 


A+1 


CHARACTER- MANTISSA (NOT NECESSARILY NORMALIZED; 
ISTIC (BIASED CONTAINS RESIDUE, LEAST SIGNIFICANT 
EXPONENT) WORD OF PRODUCT, OR REMAINDER) 


DOUBLE-PRECISION FLOATING-POINT OPERAND OR RESULT (See Instruction 
Functions 76 10—17) 
AorU 


CHARACTERISTIC 
(BIASED 
EXPONENT) MANTISSA 


A+1 or U+1 


MANTISSA 


STORAGE LIMITS REGISTER (SLR) 


|-BANK I-BANK D-BANK D-BANK 
UPPER LIMIT LOWER LIMIT UPPER LIMIT LOWER LIMIT 


35 9 0 


These are 9-bit absolute (relative, on the 1110) core block indicators, allowing program 
addressing ranges up to 262K. 


SE I FE I SSD GL DE ESI ETL IE IOS 
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FIXED ADDRESS ASSIGNMENTS 


These are all interrupt locations, except the three status words in 200g—202g and the 
day clock count in 216g. 


DECIMAL }| OCTAL 
ADDRESS | ADDRESS UNIVAC 1106/1108 USE UNIVAC 1110 USE 


Status word for external inter-| CAU 0 external interrupt 
rupt on CPU #0 status word IOAU 0 


CAU 1 external interrupt 
status word |OAU 0 


Status word for external inter- 
rupt on CPU #1 


Status word for external inter- 
rupt on CPU #2 


CAU 2 external interrupt 
status word IOAU 0 


CAU 3 external interrupt 
status word I|OAU 0 


Unassigned 


CAU 4 external interrupt 
status word l[OAU 0 


Unassigned 


CAU 5 external interrupt 
status word l|OAU 0 


Unassigned 


Unassigned Same 


Power loss interrupt Same 


ESI access control word parity 
error interrupt 


Jump History Interrupt 


IOAU ACR read parity 
check interrupt (status 
to 0260—0263) 


ISI access control word parity 
error interrupt 


IOAU storage parity 
check interrupt (status 
to 0260—0263) 


1/O data parity error inter- 
rupt 


IOAU channel parity in- 
terrupt (status to 0O260~ 
0263) 


Unassigned 


CAU/IOAU interface par- 
ity interrupt (status to 
GRS 052) 


Unassigned 


Day clock input Same 


Day clock interrupt Same 


ISI input monitor interrupt Same 


IS! output monitor interrupt] Same 


ISI function monitor interrupt | Same 


ISI external interrupt Same 


ESI input monitor interrupt Unassigned 


ESI output monitor interrupt] Unassigned 


Unassigned ES! table full interrupt 


ESI tabling occurred in- 
terrupt 


ESI external interrupt 


Undefined sequence in- 
terrupt (status to GRS 
054) 


Status word for external inter- 
rupt on unit processor (T 
#3011-—99); unassigned for 
other CPUs 


Real-time clock interrupt Same 


System interrupt (inter- 
processor) (status to GRS 
055) 


Interprocessor interrupt #0 


Interprocessor interrupt #1 Unassigned 


Sp Oc A TP SS PS 5 CA ES PT ES ET TE II 
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DECIMAL} OCTAL 
ADDRESS | ADDRESS UNIVAC 1106/1108 USE UNIVAC 1110 USE 
156 234 


Unassigned 
157 235 


Storage parity interrupt 
(status to GRS 051) 


Main storage parity error in- 
terrupt (MEM2) 


Unassigned 


158 236 Main storage parity error in- 


terrupt (MEM3) 


Unassigned 


159 237 Main storage parity error in- 


terrupt (MEM4) 


Unassigned 


160 240 GRS parity error inter- 


rupt (no status stored) 


Control register parity error 
interrupt 


161 241 Illegal instruction operation 
(EXEC 8 mnemonic: IOPR) 


fault interrupt 


iWlegal instruction inter- 
rupt (no status stored) 


Executive Request (ER) inter- 
rupt. See instruction function 
72:11 


Executive Request inter- 
rupt (no status stored) 


Guard mode fault inter- 
rupt (status to GRS 053) 


Guard mode (EXEC 8 mne- 
monic: IGDM)/storage limits 
protection fault interrupt 


Test and set (TS) interrupt.| Same 


See instruction function 73 17 


Floating-point characteristic] Same 
underflow (EXEC 8 mne- 


monic: IFUF) interrupt 


Floating-point characteristic 
overflow (EXEC 8 mnemonic: 
IFOF) interrupt 


Divide overflow fault inter- 
rupt (EXEC 8 mnemonic: 
IDOF) 


250 Unassigned CAU 0 external interrupt 


status word IOAU 1 


169 251 Unassigned CAU 1 external interrupt 


status word IOAU 1 


252 Unassigned CAU 2 external interrupt 


status word [OAU 1 


171 253 Unassigned CAU 3 external interrupt 


status word l[OAU 1 


172 254 Unassigned CAU 4 external interrupt 


status word IOAU 1 


173 255 Unassigned CAU 5 external interrupt 


status word IOAU 1 


174 256 


Unassigned Same 


175 257 Unassigned Same 


176 260 Through 377, status words for 


external interrupts from !OCs 


IOAU O internal interrupt 
status word 


177 261 1OAU 1 internal interrupt 


status word 


178 262 


IOAU 2 internal interrupt 
status word 


179 263 IOAU 3 internal interrupt. 


status word 


180 264 


Breakpoint interrupt 


Last Address—1 Main storage parity error in- 


terrupt (MEM 1) 


Parity check interrupt 
memory 1 (status toGRS 
051) 


SA RI I EE SS ID 
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HARDWARE STATUS CODES 


BIT 
POSITION UNISERVO VI-C/VIlI-C MAGNETIC TAPE SUBSYSTEM 


UNASSIGNED 

ABNORMAL FRAME COUNT 

(POSSIBLE) END OF FILE 

END-OF-TAPE WARNING/LOAD POINT 

INTERLOCK 

BUSY 

PARITY ERROR 

LATE ACKNOWLEDGE ERROR 

TAPE HASH 

INVALID FUNCTION 

BAD TRACK 

NORMALLY A ONE BIT; A ZERO BIT FOR CHANNEL PARITY 
(1110 ONLY) 

FRAME COUNT/MODULO 6 (FOR 7 TRACK) OR MODULO 9 (FOR 
9 TRACK) 


- : DATA OVER- 
VENTION CHECK RUN 
RE- 
QUIRED 
7 


TAPE 
UNIT IN- 
COMPAT- 
IBILITY 


CHECK 

TRACK 

START 
FAILURE/ 


STALL | TAPE TEST 
| test | FAULT 
ALWAYS 0 BITS 
NOTE: 


Asterisk (*) indicates a bit that is conditioned by current status of tape unit. 


Legend: 

CRC -—_ cyclic redundancy check 

LRC — longitudinal redundancy check 
R/W —_ read/write 

VRC — vertical redundancy check 


CODE 
(OCTAL) FH-432/1782 (T5012 CU), FH-432 (T6013 CU), AND FH-880 


LATE ACKNOWLEDGE (T5012 CU ONLY) 

END OF BLOCK 

SEARCH FIND 

OVERFLOW PARITY ERROR 

NONCONTINUOUS READ PARITY ERROR (EXCEPT FOR T5012 
CU). ALSO CHARACTER COUNT ERROR (FH-880 ONLY) 

FAULT 

CHANNEL PARITY (15012/1110 ONLY) 

ANGULAR ADDRESS (T5012 ONLY) 

SYNCHRONIZER CHARACTER COUNT ERROR (FH-880 ONLY) 
END-OF-FILE 

NORMAL COMPLETION 

ILLEGAL FUNCTION 

ILLEGAL ADDRESS 
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CODE 
(OCTAL) FH-432/1782 (T5012 CU), FH-432 (T6013 CU), AND FH-880 


CONTROL SEQUENCE ERROR (FH-880 ONLY) 

PARITY ERROR (T5012 CU ONLY) 

CONTINUOUS READ PARITY ERROR (EXCEPT FOR 15012 CU) 
WRITE CHARACTER COUNT ERROR (FH-880 ONLY) 


CODE 
(OCTAL) FASTRAND/8460 MASS STORAGE SUBSYSTEM 


TIME OUT ({NPUT) 

END-OF-POSITION (INPUT) 

PHASE CHECK ERROR 
NONRECONSTRUCTIBLE ERROR 

DATA RECOVERED 

ADDRESS ERROR 

LATE ACKNOWLEDGE 

END-OF-POSITION (OUTPUT) 

SECTOR LENGTH ERROR 

NORMAL COMPLETION 

INVALID FUNCTION CODE 

NO RESPONSE/WRITE LOCKOUT 

WRITER ERROR 

CHANNEL PARITY ON DATA (1110 ONLY) 
CHANNEL PARITY ON EXTERNAL FUNCTION (1110 ONLY) 


CODE 
(OCTAL) PUNCHED CARD SUBSYSTEM 


SYNCHRONIZER SEQUENCE ERROR 
SYNCHRONIZER COUNTER ERROR 
NORMAL COMPLETION 

ILLEGAL FUNCTION 

READ/PUNCH CHECK ERROR 
INAPPROPRIATE FUNCTION CODE 
1LLEGAL CHARACTER CODE 
INTERLOCK FAULT 


HIGH-SPEED PRINTER SUBSYSTEM (T7299 CU OR T5011 CU) 


NORMAL COMPLETION 

OUT OF FORMS 

INVALID FUNCTION 

PRIORITY CONFLICT (T5011 CU ONLY) 
SHARED PATH AVAILABLE (T5011 CU ONLY) 
MEMORY COMPARE ERROR (T5011 CU ONLY) 
INTERLOCK FAULT 


DISC HARDWARE STATUS CODES 


STATUS AND FLAG MASK BYTE 


STATUS | ATTEN- | STATUS a eee CHANNEL aca pees UNIT 

BYTE TION SEPA RIT on END END CHECK EXCEP- 
TION 

FLAG 

BYTE 


Odd No. | Overflow Defective | Alternate 
Record Record Track Track 
(Not Last) 


EL IEE I FE I EI ET DE I EL FT IL TEE 
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8414/8424 SENSE DATA BYTE FORMAT 


SENSE 
DATA 
BYTE BITO BIT 1 BIT 2 BIT3 BIT 4 BITS 
0 - - DATA OVER- 
CHECK RUN 
REJECT 
1 TRACK | CYLIN- FILE MISSING 
OVER- DER RECORD PRO- |ADORESS 
RUN END FOUND | TECTED {MARKER 
2 UNSAFE UNSE- 
LECTED 
STATUS 
0) 
3 
4 ALWAYS 0 


THIS BYTE IS ALL O'S EXCEPT WHEN BIT 7 OF BYTE 1 IS SET 
(OVERFLOW INCOMPLETE). 


8440 SENSE DATA BYTE FORMAT 


COM- 
MAND 
REJECT 


NO FILE MISSING 
RECORD PRO- jADORESS 
FOUND | TECTED | MARKER 


DEVICE NO QUEUING] PRIORITY] UNSE- | SECTOR 
MAL- DEVICE | PARITY TER- LECTED | ERROR 
FUNC- CLOCKS MINATE | STATUS 
TION RECEIVED 


ONLINE | UNSAFE | KEY ECC] ONLINE | END OF 
CHECK CYLIN- 

DER- 

DEVICE 


ALWAYS 0 


THIS BYTE IS 0'S EXCEPT WHEN BIT 7 OF BYTE 1 ISSET (OVERFLOW COMPLETE). 


MSA STATUS WORD FORMAT 


A 
B DA 
Cc 
17 7 0 
0 7 O 7 
Bytes 
ABC Bit 17 Abnormal Byte Count 
E Bit 16 Error Condition Detected By MSA 
DS Device Status Byte 
ATT Bit 15 Attention 
SM Bit 14 Status Modifier 
CUE Bit 13 Control Unit End 
B Bit 12 Busy 
CE Bit 11 Channel End 
DE Bit 10 Device End 
UC Bit 9 Unit Check 
UE Bit 8 Unit Exception 
DA Bits 7—0 Device Address Byte 


NOTE: 


Shaded bit positions are unused and should be zero-filled. 


LRAT NL LS EN DS SE SE I SE EE IEA a NOES IE TES ESE LETS EOE ET 
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MSA AUXILIARY STATUS WORD FORMAT 


NOTE: 


Conditions setting bit positions 7-17 cause bit position 16 of the normal status word 
to be set. Shaded bit positions are unused and zero-filled. 


NOP Bit 17 Control Unit Nonoperational 
IPE Bit 16 Input Parity Error 

TCK Bit 15 Time Check 

CLE Bit 14 Control Line Error 

ACP Bit 13 Address Compare Error 
XCK Bit 12 Translate Check 

LA Bit 11 Late Acknowledge 

Sc Bit 10 Stall Check 

WPC Bit 9 Word Parity Check (Channel Parity) 
IS Bit 8 Invalid Sequence 

IC Bit 7 invalid Command 

FA Bits 6-4 Function Address 

M Bits 3-0 Magnitude of Byte Count 


POSITIVE AND NEGATIVE POWERS OF 
2 (BINARY), 8 (OCTAL) AND 16 (HEXADECIMAL) 


DECIMAL VALUE 


ER ETI EL IST EI EE TS SS SI SIRE I ET STE PIPETTE TE IIIS 
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POWER OF 


DECIMAL VALUE 


A STE TT GAR LE ITE EN SIE FET IES ET ER AE IETS TT TE ELLIO LIL 
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